ConnectionStringEditor Classe

Referência

Definição

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma classe base para uma interface do usuário selecionar e editar uma propriedade de cadeia de conexão em tempo de design.

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

Herança: Object

UITypeEditor
ConnectionStringEditor

Derivado: System.Web.UI.Design.WebControls.SqlDataSourceConnectionStringEditor

Exemplos

O exemplo de código a seguir demonstra como associar uma instância da classe a ConnectionStringEditor uma propriedade contida em um controle personalizado. Quando a propriedade de controle é editada na superfície de design, a ConnectionStringEditor classe fornece a interface do usuário para selecionar e editar uma cadeia de conexão para o valor da propriedade.

// 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

Comentários

Uma instância da ConnectionStringEditor classe é um UITypeEditor objeto que pode ser usado em tempo de design para selecionar e editar uma expressão de cadeia de conexão e atribuir a expressão a uma propriedade de controle. Por exemplo, o SqlDataSource controle usa a ConnectionStringEditor classe em tempo de design para definir o valor da ConnectionString propriedade.

Use o EditorAttribute atributo para associar a ConnectionStringEditor uma propriedade. Quando a propriedade associada é editada na superfície de design, o host do designer chama o EditValue método. O EditValue método exibe uma interface do usuário para criar a expressão de cadeia de conexão e retorna a cadeia de conexão selecionada pelo usuário. O GetEditStyle método indica o estilo de exibição da interface do usuário.

Construtores

ConnectionStringEditor()

Inicializa uma nova instância da classe ConnectionStringEditor.

Propriedades

IsDropDownResizable

Obtém um valor que indica se os editores de lista suspensa devem ser redimensionáveis pelo usuário.

(Herdado de UITypeEditor)

Métodos

EditValue(IServiceProvider, Object)	Edita o valor do objeto especificado usando o estilo de editor indicado pelo método GetEditStyle(). (Herdado de UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)	Edita o valor do objeto especificado usando o provedor de serviços e o contexto especificados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEditStyle()	Obtém o estilo de editor usado pelo método EditValue(IServiceProvider, Object). (Herdado de UITypeEditor)
GetEditStyle(ITypeDescriptorContext)	Retorna o estilo de edição associado ao editor da cadeia de conexão para o contexto especificado.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPaintValueSupported()	Indica se esse editor é compatível com pintura de uma representação do valor de um objeto. (Herdado de UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)	Indica se o contexto especificado é compatível com pintura de uma representação do valor de um objeto no contexto especificado. (Herdado de UITypeEditor)
GetProviderName(Object)	Retorna o nome do provedor para a instância fornecida da classe ConnectionStringEditor.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
PaintValue(Object, Graphics, Rectangle)	Pinta uma representação do valor do objeto especificado na tela especificada. (Herdado de UITypeEditor)
PaintValue(PaintValueEventArgs)	Pinta uma representação do valor de um objeto usando o PaintValueEventArgs especificado. (Herdado de UITypeEditor)
SetProviderName(Object, DesignerDataConnection)	Coloca o nome do provedor na instância especificada da classe ConnectionStringEditor.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a