ConnectionStringEditor Classe

Definição

Espaço de Nomes:
System.Web.UI.Design
Assemblagem:
System.Design.dll

Fornece uma classe base para uma interface de utilizador para selecionar e editar uma propriedade de cadeia de ligação no momento do 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

Exemplos

O exemplo de código seguinte demonstra como associar uma instância da ConnectionStringEditor classe a uma propriedade contida num controlo personalizado. Quando a propriedade de controlo é editada na superfície de design, a classe ConnectionStringEditor fornece a interface do utilizador para selecionar e editar um cadeia de ligaçã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

Observações

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

Use o EditorAttribute atributo para associar o ConnectionStringEditor a uma propriedade. Quando a propriedade associada é editada na superfície de design, o hospedeiro designer chama o EditValue método. O método EditValue apresenta uma interface de utilizador para construir a expressão cadeia de ligação e devolve a cadeia de ligação selecionada pelo utilizador. O GetEditStyle método indica o estilo de apresentação da interface de utilizador.

Construtores

Name Description
ConnectionStringEditor()

Inicializa uma nova instância da ConnectionStringEditor classe.

Propriedades

Name Description
IsDropDownResizable

Recebe um valor que indica se os editores de menu suspenso devem ser redimensionáveis pelo utilizador.

(Herdado de UITypeEditor)

Métodos

Name Description
EditValue(IServiceProvider, Object)

Edita o valor do objeto especificado usando o estilo de editor indicado pelo GetEditStyle() método.

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

Edita o valor do objeto especificado usando o fornecedor de serviço e o contexto especificados.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEditStyle()

Obtém o estilo editor usado pelo EditValue(IServiceProvider, Object) método.

(Herdado de UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

Devolve o estilo de edição associado ao editor de cadeia de ligação para o contexto especificado.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetPaintValueSupported()

Indica se este editor suporta a pintura de uma representação do valor de um objeto.

(Herdado de UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

Indica se o contexto especificado suporta a pintura de uma representação do valor de um objeto dentro do contexto especificado.

(Herdado de UITypeEditor)
GetProviderName(Object)

Devolve o nome do fornecedor para a instância fornecida da ConnectionStringEditor classe.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(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 especificado PaintValueEventArgs.

(Herdado de UITypeEditor)
SetProviderName(Object, DesignerDataConnection)

Coloca o nome do fornecedor na instância especificada da ConnectionStringEditor classe.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também