Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

EntityConnectionStringBuilder-Klasse

Bietet eine einfache Möglichkeit, den Inhalt von Verbindungszeichenfolgen für den EntityClient zu erstellen und zu verwalten.

System.Object
  System.Data.Common.DbConnectionStringBuilder
    System.Data.EntityClient.EntityConnectionStringBuilder

Namespace:  System.Data.EntityClient
Assembly:  System.Data.Entity (in System.Data.Entity.dll)
public sealed class EntityConnectionStringBuilder : DbConnectionStringBuilder

Der EntityConnectionStringBuilder-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode EntityConnectionStringBuilder() Initialisiert eine neue Instanz der EntityConnectionStringBuilder-Klasse.
Öffentliche Methode EntityConnectionStringBuilder(String) Initialisiert mithilfe der angegebenen Verbindungszeichenfolge eine neue Instanz der EntityConnectionStringBuilder-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft BrowsableConnectionString Ruft einen Wert ab, der angibt, ob die ConnectionString-Eigenschaft in Visual Studio-Designern sichtbar ist, oder legt diesen fest. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Eigenschaft ConnectionString Ruft die Verbindungszeichenfolge ab, die dem DbConnectionStringBuilder zugeordnet ist, oder legt diese fest. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Eigenschaft Count Ruft die aktuelle Anzahl von Schlüsseln ab, die innerhalb der ConnectionString-Eigenschaft enthalten sind. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Eigenschaft IsFixedSize Ruft einen Wert ab, der angibt, ob die EntityConnectionStringBuilder eine feste Größe hat. (Überschreibt DbConnectionStringBuilder.IsFixedSize.)
Öffentliche Eigenschaft IsReadOnly Ruft einen Wert ab, der angibt, ob DbConnectionStringBuilder schreibgeschützt ist. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Eigenschaft 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].)
Öffentliche Eigenschaft Keys Ruft eine ICollection ab, die die Schlüssel im EntityConnectionStringBuilder enthält. (Überschreibt DbConnectionStringBuilder.Keys.)
Öffentliche Eigenschaft Metadata Ruft die Speicherorte der Metadaten in der Verbindungszeichenfolge ab oder legt diese fest.
Öffentliche Eigenschaft Name Ruft den in einer Konfigurationsdatei definierten Namen eines Abschnitts ab oder legt diesen fest.
Öffentliche Eigenschaft Provider Ruft den Namen des zugrunde liegenden .NET Framework-Datenanbieters in der Verbindungszeichenfolge ab oder legt diesen fest.
Öffentliche Eigenschaft ProviderConnectionString Ruft die innere, anbieterspezifische Verbindungszeichenfolge ab oder legt diese fest.
Öffentliche Eigenschaft Values Ruft eine ICollection ab, die die Werte im DbConnectionStringBuilder enthält. (Von DbConnectionStringBuilder geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Add Fügt dem DbConnectionStringBuilder einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Methode Clear Löscht den Inhalt der EntityConnectionStringBuilder-Instanz. (Überschreibt DbConnectionStringBuilder.Clear().)
Geschützte Methode ClearPropertyDescriptors Löscht die Auflistung von PropertyDescriptor-Objekten auf dem zugeordneten DbConnectionStringBuilder. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Methode ContainsKey Bestimmt, ob EntityConnectionStringBuilder einen bestimmten Schlüssel enthält. (Überschreibt DbConnectionStringBuilder.ContainsKey(String).)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Öffentliche Methode EquivalentTo Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder-Objekt mit den Verbindungsinformationen im angegebenen Objekt. (Von DbConnectionStringBuilder geerbt.)
Geschützte Methode 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.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Geschützte Methode GetProperties Füllt eine angegebene Hashtable mit Informationen zu allen Eigenschaften von diesem DbConnectionStringBuilderaus. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Remove Entfernt den Eintrag mit dem angegebenen Schlüssel aus der EntityConnectionStringBuilder-Instanz. (Überschreibt DbConnectionStringBuilder.Remove(String).)
Öffentliche Methode ShouldSerialize Gibt an, ob der angegebene Schlüssel in dieser DbConnectionStringBuilder-Instanz vorhanden ist. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Methode ToString Gibt die diesem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge zurück. (Von DbConnectionStringBuilder geerbt.)
Öffentliche Methode TryGetValue Ruft einen Wert ab, der dem von diesem EntityConnectionStringBuilder bereitgestellten Schlüssel entspricht. (Überschreibt DbConnectionStringBuilder.TryGetValue(String, Object).)
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Methode ICollection.CopyTo Kopiert die Elemente der ICollection beginnend bei einem bestimmten Array-Index in ein Array. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft ICollection.IsSynchronized Ruft einen Wert ab, der angibt, ob der Zugriff auf ICollection synchronisiert (threadsicher) ist. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft ICollection.SyncRoot Ruft ein Objekt ab, mit dem der Zugriff auf die ICollection synchronisiert werden kann. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetAttributes Gibt eine Auflistung benutzerdefinierter Attribute für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetClassName Gibt den Klassennamen dieser Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetComponentName Gibt den Namen dieser Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetConverter Gibt einen Typkonverter für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetDefaultEvent Gibt das Standardereignis für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetDefaultProperty Gibt die Standardeigenschaft für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetEditor Gibt einen Editor vom angegebenen Typ für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetEvents() Gibt die Ereignisse für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetEvents(Attribute[]) Gibt die Ereignisse für diese Instanz einer Komponente unter Verwendung des angegebenen Attributarrays als Filter zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetProperties() Gibt die Eigenschaften für diese Instanz einer Komponente zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetProperties(Attribute[]) Gibt die Eigenschaften für diese Instanz einer Komponente unter Verwendung des Attributarrays als Filter zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode ICustomTypeDescriptor.GetPropertyOwner Gibt ein Objekt zurück, in dem die vom angegebenen Eigenschaftendeskriptor beschriebene Eigenschaft enthalten ist. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode IDictionary.Add Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode IDictionary.Contains Ermittelt, ob das IDictionary-Objekt ein Element mit dem angegebenen Schlüssel enthält. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode IDictionary.GetEnumerator Gibt ein IDictionaryEnumerator-Objekt für das IDictionary-Objekt zurück. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IDictionary.Item Ruft das Element mit dem angegebenen Schlüssel ab oder legt dieses fest. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode IDictionary.Remove Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary-Objekt. (Von DbConnectionStringBuilder geerbt.)
Explizite Schnittstellenimplementierung Private Methode IEnumerable.GetEnumerator Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von DbConnectionStringBuilder geerbt.)
Zum Seitenanfang

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 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();
}


.NET Framework

Unterstützt in: 4, 3.5 SP1

.NET Framework Client Profile

Unterstützt in: 4

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.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?