Condividi tramite

ConnectionStringEditor Classe

Definizione

Spazio dei nomi:
System.Web.UI.Design
Assembly:
System.Design.dll

Fornisce una classe base per un'interfaccia utente per selezionare e modificare una proprietà della stringa di connessione in fase di progettazione.

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
Ereditarietà
Object
UITypeEditor
ConnectionStringEditor
Derivato

Esempio

Nell'esempio di codice seguente viene illustrato come associare un'istanza della ConnectionStringEditor classe a una proprietà contenuta in un controllo personalizzato. Quando la proprietà del controllo viene modificata nell'area di progettazione, la ConnectionStringEditor classe fornisce l'interfaccia utente per selezionare e modificare una stringa di connessione per il valore della proprietà.

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

Commenti

Un'istanza della ConnectionStringEditor classe è un UITypeEditor oggetto che può essere utilizzato in fase di progettazione per selezionare e modificare un'espressione di stringa di connessione e per assegnare l'espressione a una proprietà del controllo. Ad esempio, il SqlDataSource controllo usa la ConnectionStringEditor classe in fase di progettazione per impostare il valore della ConnectionString proprietà .

Utilizzare l'attributo per associare l'oggetto EditorAttributeConnectionStringEditor a una proprietà . Quando la proprietà associata viene modificata nell'area di progettazione, l'host della finestra di progettazione chiama il EditValue metodo . Il EditValue metodo visualizza un'interfaccia utente per la compilazione dell'espressione della stringa di connessione e restituisce la stringa di connessione selezionata dall'utente. Il GetEditStyle metodo indica lo stile di visualizzazione dell'interfaccia utente.

Costruttori

Nome Descrizione
ConnectionStringEditor()

Inizializza una nuova istanza della classe ConnectionStringEditor.

Proprietà

Nome Descrizione
IsDropDownResizable

Ottiene un valore che indica se gli editor a discesa devono essere ridimensionati dall'utente.

(Ereditato da UITypeEditor)

Metodi

Nome Descrizione
EditValue(IServiceProvider, Object)

Modifica il valore dell'oggetto specificato utilizzando lo stile dell'editor indicato dal GetEditStyle() metodo .

(Ereditato da UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)

Modifica il valore dell'oggetto specificato utilizzando il provider di servizi e il contesto specificati.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetEditStyle()

Ottiene lo stile dell'editor utilizzato dal EditValue(IServiceProvider, Object) metodo .

(Ereditato da UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

Restituisce lo stile di modifica associato all'editor di stringhe di connessione per il contesto specificato.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetPaintValueSupported()

Indica se questo editor supporta il disegno di una rappresentazione del valore di un oggetto.

(Ereditato da UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

Indica se il contesto specificato supporta il disegno di una rappresentazione del valore di un oggetto all'interno del contesto specificato.

(Ereditato da UITypeEditor)
GetProviderName(Object)

Restituisce il nome del provider per l'istanza specificata della ConnectionStringEditor classe .
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
PaintValue(Object, Graphics, Rectangle)

Disegna una rappresentazione del valore dell'oggetto specificato nell'area di disegno specificata.

(Ereditato da UITypeEditor)
PaintValue(PaintValueEventArgs)

Disegna una rappresentazione del valore di un oggetto utilizzando l'oggetto specificato PaintValueEventArgs.

(Ereditato da UITypeEditor)
SetProviderName(Object, DesignerDataConnection)

Inserisce il nome del provider nell'istanza specificata della ConnectionStringEditor classe .
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche