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 zum Auswählen und Bearbeiten einer Verbindungszeichenfolgeneigenschaft zur Entwurfszeit bereit.
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 verwendet werden kann, um einen Verbindungszeichenfolgenausdruck auszuwählen und zu bearbeiten und den Ausdruck einer Steuerelementeigenschaft zuzuweisen. Beispielsweise verwendet das SqlDataSource Steuerelement die ConnectionStringEditor Klasse zur Entwurfszeit, um den Wert der ConnectionString Eigenschaft festzulegen.
Verwenden Sie das EditorAttribute Attribut, um die ConnectionStringEditor Eigenschaft zuzuordnen. Wenn die zugeordnete Eigenschaft auf der Entwurfsoberfläche bearbeitet wird, ruft der Designerhost die EditValue Methode auf. 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
| Name | Beschreibung |
|---|---|
| ConnectionStringEditor() |
Initialisiert eine neue Instanz der ConnectionStringEditor-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsDropDownResizable |
Ruft einen Wert ab, der angibt, ob Die Größe von Dropdown-Editoren vom Benutzer geändert werden soll. (Geerbt von UITypeEditor) |
Methoden
| Name | Beschreibung |
|---|---|
| EditValue(IServiceProvider, Object) |
Bearbeitet den Wert des angegebenen Objekts mithilfe der von der GetEditStyle() Methode angegebenen Editorformatvorlage. (Geerbt von UITypeEditor) |
| EditValue(ITypeDescriptorContext, IServiceProvider, Object) |
Bearbeitet den Wert des angegebenen Objekts mithilfe des angegebenen Dienstanbieters und kontexts. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetEditStyle() |
Ruft die editor-Formatvorlage ab, die von der EditValue(IServiceProvider, Object) Methode verwendet wird. (Geerbt von UITypeEditor) |
| GetEditStyle(ITypeDescriptorContext) |
Gibt die Bearbeitungsformatvorlage zurück, die dem Verbindungszeichenfolgen-Editor für den angegebenen Kontext zugeordnet ist. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetPaintValueSupported() |
Gibt an, ob dieser Editor das Zeichnen einer Darstellung des Werts eines Objekts unterstützt. (Geerbt von UITypeEditor) |
| GetPaintValueSupported(ITypeDescriptorContext) |
Gibt an, ob der angegebene Kontext das Zeichnen einer Darstellung des Werts eines Objekts innerhalb des angegebenen Kontexts unterstützt. (Geerbt von UITypeEditor) |
| GetProviderName(Object) |
Gibt den Anbieternamen für die angegebene Instanz der ConnectionStringEditor Klasse zurück. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| PaintValue(Object, Graphics, Rectangle) |
Zeichnet eine Darstellung des Werts des angegebenen Objekts an den angegebenen Zeichenbereich. (Geerbt von UITypeEditor) |
| PaintValue(PaintValueEventArgs) |
Zeichnet eine Darstellung des Werts eines Objekts mithilfe des angegebenen PaintValueEventArgs. (Geerbt von UITypeEditor) |
| SetProviderName(Object, DesignerDataConnection) |
Fügt den Anbieternamen in die angegebene Instanz der ConnectionStringEditor Klasse ein. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
