ConnectionStringEditor Klasse

Referenz

Definition

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Basisklasse für eine Benutzeroberfläche bereit, mit der eine Eigenschaft einer Verbindungszeichenfolge zur Entwurfszeit ausgewählt und bearbeitet werden kann.

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

Vererbung: Object

UITypeEditor
ConnectionStringEditor

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz der ConnectionStringEditor -Klasse einer Eigenschaft zugeordnet wird, die in einem benutzerdefinierten Steuerelement enthalten ist. Wenn die Steuerelementeigenschaft auf der Entwurfsoberfläche bearbeitet wird, stellt die ConnectionStringEditor -Klasse die Benutzeroberfläche bereit, um eine Verbindungszeichenfolge für den Eigenschaftswert auszuwählen und zu bearbeiten.

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

Hinweise

Eine Instanz der ConnectionStringEditor -Klasse ist ein UITypeEditor Objekt, das zur Entwurfszeit zum Auswählen und Bearbeiten eines Verbindungszeichenfolgenausdrucks und zum Zuweisen des Ausdrucks zu einer Steuerelementeigenschaft verwendet werden kann. Beispielsweise verwendet das SqlDataSource Steuerelement die ConnectionStringEditor -Klasse zur Entwurfszeit, um den Wert der ConnectionString Eigenschaft festzulegen.

Verwenden Sie das EditorAttribute -Attribut, um eine ConnectionStringEditor -Eigenschaft zuzuordnen. Wenn die zugeordnete Eigenschaft auf der Entwurfsoberfläche bearbeitet wird, ruft der Designerhost die -Methode auf EditValue . Die EditValue -Methode zeigt eine Benutzeroberfläche zum Erstellen des Verbindungszeichenfolgenausdrucks an und gibt die vom Benutzer ausgewählte Verbindungszeichenfolge zurück. Die GetEditStyle -Methode gibt den Anzeigestil der Benutzeroberfläche an.

Konstruktoren

ConnectionStringEditor()

Initialisiert eine neue Instanz der ConnectionStringEditor-Klasse.

Eigenschaften

IsDropDownResizable

Ruft einen Wert ab, der angibt, ob Dropdowneditoren von den Benutzern in der Größe veränderbar sein sollten.

(Geerbt von UITypeEditor)

Methoden

EditValue(IServiceProvider, Object)	Bearbeitet den Wert des angegebenen Objekts, wobei der von der GetEditStyle()-Methode angegebene Editor-Stil verwendet wird. (Geerbt von UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)	Bearbeitet den Wert des angegebenen Objekts unter Verwendung des angegebenen Diensts und des angegebenen Kontexts.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEditStyle()	Ruft den von der EditValue(IServiceProvider, Object)-Methode verwendeten Editor-Stil ab. (Geerbt von UITypeEditor)
GetEditStyle(ITypeDescriptorContext)	Gibt den Bearbeitungsstil zurück, der diesem Verbindungszeichenfolgen-Editor für den angegebenen Kontext zugeordnet ist.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPaintValueSupported()	Gibt an, ob dieser Editor das Zeichnen einer Objektwertdarstellung unterstützt. (Geerbt von UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)	Gibt an, ob der angegebene Kontext das Zeichnen einer Objektwertdarstellung innerhalb des angegebenen Kontexts unterstützt. (Geerbt von UITypeEditor)
GetProviderName(Object)	Gibt den Anbieternamen für die bereitgestellte Instanz der ConnectionStringEditor-Klasse zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
PaintValue(Object, Graphics, Rectangle)	Zeichnet eine Darstellung des Werts des angegebenen Objekts in den angegebenen Bereich. (Geerbt von UITypeEditor)
PaintValue(PaintValueEventArgs)	Zeichnet die Darstellung eines Objektwerts mit dem angegebenen PaintValueEventArgs. (Geerbt von UITypeEditor)
SetProviderName(Object, DesignerDataConnection)	Legt den Anbieternamen für die angegebene Instanz der ConnectionStringEditor-Klasse fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: