Share via

ConnectionStringEditor Classe

  • Riferimento

Definizione

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

Fornisce una classe base per un'interfaccia utente per la selezione e la modifica di una proprietà di 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 all'interno di 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 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 EditorAttribute per associare l'oggetto ConnectionStringEditor 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

ConnectionStringEditor()

Inizializza una nuova istanza della classe ConnectionStringEditor.

Proprietà

IsDropDownResizable

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

(Ereditato da UITypeEditor)

Metodi

EditValue(IServiceProvider, Object)

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

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

Consente di modificare 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 usato dal metodo EditValue(IServiceProvider, Object).

(Ereditato da UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

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

Funge da funzione hash predefinita.

(Ereditato da Object)
GetPaintValueSupported()

Indica se questo editor supporta la rappresentazione grafica del valore di un oggetto.

(Ereditato da UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

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

(Ereditato da UITypeEditor)
GetProviderName(Object)

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

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

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

Descrive graficamente il valore dell'oggetto specificato sulla superficie specificata.

(Ereditato da UITypeEditor)
PaintValue(PaintValueEventArgs)

Descrive graficamente il valore di un oggetto usando la classe PaintValueEventArgs specificata.

(Ereditato da UITypeEditor)
SetProviderName(Object, DesignerDataConnection)

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

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche