Compartir a través de

ConnectionStringEditor Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.Design
Ensamblado:
System.Design.dll

Proporciona una clase base para una interfaz de usuario para seleccionar y editar propiedades de cadena de conexión en tiempo de diseño.

public ref class ConnectionStringEditor : System::Drawing::Design::UITypeEditor
public class ConnectionStringEditor : System.Drawing.Design.UITypeEditor
type ConnectionStringEditor = class
    inherit UITypeEditor
Public Class ConnectionStringEditor
Inherits UITypeEditor
Herencia
Object
UITypeEditor
ConnectionStringEditor
Derivado

Ejemplos

En el ejemplo de código siguiente se muestra cómo asociar una instancia de la ConnectionStringEditor clase con una propiedad contenida en un control personalizado. Cuando la propiedad de control se edita en la superficie de diseño, la ConnectionStringEditor clase proporciona la interfaz de usuario para seleccionar y editar una cadena de conexión para el valor de propiedad.

// Define a custom class derived from the SqlDataSource Web control. 
public class SqlDataSourceWithBackup : SqlDataSource
{
    private string _alternateConnectionString;

    // Define an alternate connection string, which could be used
    // as a fallback value if the primary connection string fails.
    
    // The EditorAttribute indicates the property can
    // be edited at design-time with the ConnectionStringEditor class.
    [
      DefaultValue(""),
      EditorAttribute(typeof(System.Web.UI.Design.ConnectionStringEditor),
                     typeof(System.Drawing.Design.UITypeEditor)),
      Category("Data"),
      Description("The alternate connection string.")
    ]
    public string AlternateConnectionString
    {
        get
        {
            return _alternateConnectionString;
        }
        set
        {
            _alternateConnectionString = value;
        }
    }
}

' Define a custom class derived from the SqlDataSource Web control. 
Public Class SqlDataSourceWithBackup
    Inherits SqlDataSource

    Private _alternateConnectionString As String

    ' Define an alternate connection string, which could be used
    ' as a fallback value if the primary connection string fails.

    ' The EditorAttribute indicates the property can
    ' be edited at design-time with the ConnectionStringEditor class.
    <DefaultValue(""), _
     EditorAttribute(GetType(System.Web.UI.Design.ConnectionStringEditor), _
         GetType(System.Drawing.Design.UITypeEditor)), _
     Category("Data"), _
     Description("The alternate connection string.")> _
   Public Property AlternateConnectionString() As String

        Get
            Return _alternateConnectionString
        End Get
        Set(ByVal value As String)
            _alternateConnectionString = value
        End Set
    End Property

End Class

Comentarios

Una instancia de la ConnectionStringEditor clase es un UITypeEditor objeto que se puede usar en tiempo de diseño para seleccionar y editar una expresión de cadena de conexión y asignar la expresión a una propiedad de control. Por ejemplo, el SqlDataSource control usa la ConnectionStringEditor clase en tiempo de diseño para establecer el valor de la ConnectionString propiedad .

Utilice el EditorAttribute atributo para asociar con ConnectionStringEditor una propiedad . Cuando la propiedad asociada se edita en la superficie de diseño, el host del diseñador llama al EditValue método . El EditValue método muestra una interfaz de usuario para compilar la expresión de cadena de conexión y devuelve la cadena de conexión seleccionada por el usuario. El GetEditStyle método indica el estilo de presentación de la interfaz de usuario.

Constructores

ConnectionStringEditor()

Inicializa una nueva instancia de la clase ConnectionStringEditor.

Propiedades

IsDropDownResizable

Obtiene un valor que indica si el usuario puede cambiar el tamaño de los editores desplegables.

(Heredado de UITypeEditor)

Métodos

EditValue(IServiceProvider, Object)

Edita el valor del objeto especificado utilizando el estilo del editor indicado por el método GetEditStyle().

(Heredado de UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)

Modifica el valor del objeto especificado mediante el proveedor de servicios y el contexto especificados.
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetEditStyle()

Obtiene el estilo de editor utilizado por el método EditValue(IServiceProvider, Object).

(Heredado de UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

Devuelve el estilo de edición que está asociado al editor de cadenas de conexión para el contexto especificado.
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetPaintValueSupported()

Indica si este editor permite dibujar una representación del valor de un objeto.

(Heredado de UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

Indica si el contexto especificado permite dibujar una representación del valor de un objeto dentro de ese contexto.

(Heredado de UITypeEditor)
GetProviderName(Object)

Devuelve el nombre del proveedor de la instancia proporcionada de la clase ConnectionStringEditor.
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
PaintValue(Object, Graphics, Rectangle)

Dibuja una representación del valor del objeto especificado en el lienzo indicado.

(Heredado de UITypeEditor)
PaintValue(PaintValueEventArgs)

Dibuja una representación del valor de un objeto utilizando el PaintValueEventArgs especificado.

(Heredado de UITypeEditor)
SetProviderName(Object, DesignerDataConnection)

Coloca el nombre del proveedor en la instancia especificada de la clase ConnectionStringEditor.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también