Compartir a través de

ConnectionStringEditor Clase

Definición

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

Proporciona una clase base para que una interfaz de usuario seleccione y edite una propiedad 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 a 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 la 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 .

Use el EditorAttribute atributo para asociar el ConnectionStringEditor objeto a 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

Nombre Description
ConnectionStringEditor()

Inicializa una nueva instancia de la clase ConnectionStringEditor.

Propiedades

Nombre Description
IsDropDownResizable

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

(Heredado de UITypeEditor)

Métodos

Nombre Description
EditValue(IServiceProvider, Object)

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

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

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

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetEditStyle()

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

(Heredado de UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

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

Actúa como función hash predeterminada.

(Heredado de Object)
GetPaintValueSupported()

Indica si este editor admite pintar una representación del valor de un objeto.

(Heredado de UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

Indica si el contexto especificado admite pintar una representación del valor de un objeto dentro del contexto especificado.

(Heredado de UITypeEditor)
GetProviderName(Object)

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

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

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

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

(Heredado de UITypeEditor)
PaintValue(PaintValueEventArgs)

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

(Heredado de UITypeEditor)
SetProviderName(Object, DesignerDataConnection)

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

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también