Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
EntityConnectionStringBuilder-Klasse
Bietet eine einfache Möglichkeit, den Inhalt von Verbindungszeichenfolgen für den EntityClient zu erstellen und zu verwalten.
System.Data.Common.DbConnectionStringBuilder
System.Data.EntityClient.EntityConnectionStringBuilder
Assembly: System.Data.Entity (in System.Data.Entity.dll)
Der EntityConnectionStringBuilder-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
EntityConnectionStringBuilder() | Initialisiert eine neue Instanz der EntityConnectionStringBuilder-Klasse. |
|
EntityConnectionStringBuilder(String) | Initialisiert mithilfe der angegebenen Verbindungszeichenfolge eine neue Instanz der EntityConnectionStringBuilder-Klasse. |
| Name | Beschreibung | |
|---|---|---|
|
BrowsableConnectionString | Ruft einen Wert ab, der angibt, ob die ConnectionString-Eigenschaft in Visual Studio-Designern sichtbar ist, oder legt diesen fest. (Von DbConnectionStringBuilder geerbt.) |
|
ConnectionString | Ruft die Verbindungszeichenfolge ab, die dem DbConnectionStringBuilder zugeordnet ist, oder legt diese fest. (Von DbConnectionStringBuilder geerbt.) |
|
Count | Ruft die aktuelle Anzahl von Schlüsseln ab, die innerhalb der ConnectionString-Eigenschaft enthalten sind. (Von DbConnectionStringBuilder geerbt.) |
|
IsFixedSize | Ruft einen Wert ab, der angibt, ob die EntityConnectionStringBuilder eine feste Größe hat. (Überschreibt DbConnectionStringBuilder.IsFixedSize.) |
|
IsReadOnly | Ruft einen Wert ab, der angibt, ob DbConnectionStringBuilder schreibgeschützt ist. (Von DbConnectionStringBuilder geerbt.) |
|
Item | Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest. In C# ist diese Eigenschaft der Indexer. (Überschreibt DbConnectionStringBuilder.Item[String].) |
|
Keys | Ruft eine ICollection ab, die die Schlüssel im EntityConnectionStringBuilder enthält. (Überschreibt DbConnectionStringBuilder.Keys.) |
|
Metadata | Ruft die Speicherorte der Metadaten in der Verbindungszeichenfolge ab oder legt diese fest. |
|
Name | Ruft den in einer Konfigurationsdatei definierten Namen eines Abschnitts ab oder legt diesen fest. |
|
Provider | Ruft den Namen des zugrunde liegenden .NET Framework-Datenanbieters in der Verbindungszeichenfolge ab oder legt diesen fest. |
|
ProviderConnectionString | Ruft die innere, anbieterspezifische Verbindungszeichenfolge ab oder legt diese fest. |
|
Values | Ruft eine ICollection ab, die die Werte im DbConnectionStringBuilder enthält. (Von DbConnectionStringBuilder geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
Add | Fügt dem DbConnectionStringBuilder einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu. (Von DbConnectionStringBuilder geerbt.) |
|
Clear | Löscht den Inhalt der EntityConnectionStringBuilder-Instanz. (Überschreibt DbConnectionStringBuilder.Clear().) |
|
ClearPropertyDescriptors | Löscht die Auflistung von PropertyDescriptor-Objekten auf dem zugeordneten DbConnectionStringBuilder. (Von DbConnectionStringBuilder geerbt.) |
|
ContainsKey | Bestimmt, ob EntityConnectionStringBuilder einen bestimmten Schlüssel enthält. (Überschreibt DbConnectionStringBuilder.ContainsKey(String).) |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
EquivalentTo | Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder-Objekt mit den Verbindungsinformationen im angegebenen Objekt. (Von DbConnectionStringBuilder geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetProperties | Füllt eine angegebene Hashtable mit Informationen zu allen Eigenschaften von diesem DbConnectionStringBuilderaus. (Von DbConnectionStringBuilder geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
Remove | Entfernt den Eintrag mit dem angegebenen Schlüssel aus der EntityConnectionStringBuilder-Instanz. (Überschreibt DbConnectionStringBuilder.Remove(String).) |
|
ShouldSerialize | Gibt an, ob der angegebene Schlüssel in dieser DbConnectionStringBuilder-Instanz vorhanden ist. (Von DbConnectionStringBuilder geerbt.) |
|
ToString | Gibt die diesem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge zurück. (Von DbConnectionStringBuilder geerbt.) |
|
TryGetValue | Ruft einen Wert ab, der dem von diesem EntityConnectionStringBuilder bereitgestellten Schlüssel entspricht. (Überschreibt DbConnectionStringBuilder.TryGetValue(String, Object).) |
| Name | Beschreibung | |
|---|---|---|
|
ICollection.CopyTo | Kopiert die Elemente der ICollection beginnend bei einem bestimmten Array-Index in ein Array. (Von DbConnectionStringBuilder geerbt.) |
|
ICollection.IsSynchronized | Ruft einen Wert ab, der angibt, ob der Zugriff auf ICollection synchronisiert (threadsicher) ist. (Von DbConnectionStringBuilder geerbt.) |
|
ICollection.SyncRoot | Ruft ein Objekt ab, mit dem der Zugriff auf die ICollection synchronisiert werden kann. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetAttributes | Gibt eine Auflistung benutzerdefinierter Attribute für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetClassName | Gibt den Klassennamen dieser Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetComponentName | Gibt den Namen dieser Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetConverter | Gibt einen Typkonverter für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetDefaultEvent | Gibt das Standardereignis für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetDefaultProperty | Gibt die Standardeigenschaft für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetEditor | Gibt einen Editor vom angegebenen Typ für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetEvents() | Gibt die Ereignisse für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetEvents(Attribute[]) | Gibt die Ereignisse für diese Instanz einer Komponente unter Verwendung des angegebenen Attributarrays als Filter zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetProperties() | Gibt die Eigenschaften für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetProperties(Attribute[]) | Gibt die Eigenschaften für diese Instanz einer Komponente unter Verwendung des Attributarrays als Filter zurück. (Von DbConnectionStringBuilder geerbt.) |
|
ICustomTypeDescriptor.GetPropertyOwner | Gibt ein Objekt zurück, in dem die vom angegebenen Eigenschaftendeskriptor beschriebene Eigenschaft enthalten ist. (Von DbConnectionStringBuilder geerbt.) |
|
IDictionary.Add | Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu. (Von DbConnectionStringBuilder geerbt.) |
|
IDictionary.Contains | Ermittelt, ob das IDictionary-Objekt ein Element mit dem angegebenen Schlüssel enthält. (Von DbConnectionStringBuilder geerbt.) |
|
IDictionary.GetEnumerator | Gibt ein IDictionaryEnumerator-Objekt für das IDictionary-Objekt zurück. (Von DbConnectionStringBuilder geerbt.) |
|
IDictionary.Item | Ruft das Element mit dem angegebenen Schlüssel ab oder legt dieses fest. (Von DbConnectionStringBuilder geerbt.) |
|
IDictionary.Remove | Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary-Objekt. (Von DbConnectionStringBuilder geerbt.) |
|
IEnumerable.GetEnumerator | Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von DbConnectionStringBuilder geerbt.) |
Mithilfe von Verbindungszeichenfolgen-Generatoren können Entwickler syntaktisch korrekte Verbindungszeichenfolgen programmgesteuert erstellen sowie vorhandene Verbindungszeichenfolgen analysieren und neu erstellen, indem Eigenschaften und Methoden der Klasse verwendet werden. Der Verbindungszeichenfolgen-Generator stellt stark typisierte Eigenschaften bereit, die den bekannten Schlüsselwort-Wert-Paaren entsprechen. Entwickler, die in einer Anwendung Verbindungszeichenfolgen erstellen müssen, können die EntityConnectionStringBuilder-Klasse verwenden, um Verbindungszeichenfolgen zu erstellen und zu ändern.
EntityConnectionStringBuilder überprüft die Gültigkeit von Schlüsselwort-Wert-Paaren, die als EntityConnectionStringBuilder-Eigenschaftswerte zur Verfügung gestellt werden.
Hinweis
|
|---|
|
Die Verbindungszeichenfolge für die zugrunde liegende Datenquelle wird von der ProviderConnectionString-Eigenschaft bereitgestellt. Die bereitgestellte Verbindungszeichenfolge wird nicht auf gültige Schlüsselwort-Wert-Paare überprüft. |
Das folgende Codebeispiel veranschaulicht die Verwendung von EntityConnectionStringBuilder mit SqlConnectionStringBuilder.
// Specify the provider name, server and database. string providerName = "System.Data.SqlClient"; string serverName = "."; string databaseName = "AdventureWorks"; // Initialize the connection string builder for the // underlying provider. SqlConnectionStringBuilder sqlBuilder = new SqlConnectionStringBuilder(); // Set the properties for the data source. sqlBuilder.DataSource = serverName; sqlBuilder.InitialCatalog = databaseName; sqlBuilder.IntegratedSecurity = true; // Build the SqlConnection connection string. string providerString = sqlBuilder.ToString(); // Initialize the EntityConnectionStringBuilder. EntityConnectionStringBuilder entityBuilder = new EntityConnectionStringBuilder(); //Set the provider name. entityBuilder.Provider = providerName; // Set the provider-specific connection string. entityBuilder.ProviderConnectionString = providerString; // Set the Metadata location. entityBuilder.Metadata = @"res://*/AdventureWorksModel.csdl| res://*/AdventureWorksModel.ssdl| res://*/AdventureWorksModel.msl"; Console.WriteLine(entityBuilder.ToString()); using (EntityConnection conn = new EntityConnection(entityBuilder.ToString())) { conn.Open(); Console.WriteLine("Just testing the connection."); conn.Close(); }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Hinweis