ConnectionStringEditor Klasse
Definition
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::UITypeEditorpublic class ConnectionStringEditor : System.Drawing.Design.UITypeEditortype ConnectionStringEditor = class
inherit UITypeEditorPublic Class ConnectionStringEditor
Inherits UITypeEditor- Vererbung
- Abgeleitet
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) |
