EntityConnectionStringBuilder Klasse

Definition

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Bietet eine einfache Möglichkeit, den Inhalt von Verbindungszeichenfolgen, die von EntityClient verwendet werden, zu erstellen und zu verwalten.

public ref class EntityConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

public sealed class EntityConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

type EntityConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class EntityConnectionStringBuilder
Inherits DbConnectionStringBuilder

Vererbung

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

Beispiele

Im folgenden Beispiel wird die Verwendung von EntityConnectionStringBuilder in Verbindung mit einem SqlConnectionStringBuilder veranschaulicht.

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

' Specify the provider name, server and database.
Dim providerName As String = "System.Data.SqlClient"
Dim serverName As String = "."
Dim databaseName As String = "AdventureWorks"

' Initialize the connection string builder for the
' underlying provider.
Dim sqlBuilder As New SqlConnectionStringBuilder

' Set the properties for the data source.
sqlBuilder.DataSource = serverName
sqlBuilder.InitialCatalog = databaseName
sqlBuilder.IntegratedSecurity = True

' Build the SqlConnection connection string.
Dim providerString As String = sqlBuilder.ToString

' Initialize the EntityConnectionStringBuilder.
Dim entityBuilder As New EntityConnectionStringBuilder

'Set the provider name.
entityBuilder.Provider = providerName
' Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString
' Set the Metadata location to the current directory.
entityBuilder.Metadata = "res://*/AdventureWorksModel.csdl|" & _
                            "res://*/AdventureWorksModel.ssdl|" & _
                            "res://*/AdventureWorksModel.msl"

Console.WriteLine(entityBuilder.ToString)

Using conn As EntityConnection = New EntityConnection(entityBuilder.ToString)
    conn.Open()
    Console.WriteLine("Just testing the connection.")
    conn.Close()
End Using

Hinweise

Mithilfe des Verbindungszeichenfolgen-Generators können Entwickler syntaktisch korrekte Verbindungszeichenfolgen programmgesteuert erstellen sowie vorhandene Verbindungszeichenfolgen analysieren und neu erstellen, indem sie Eigenschaften und Methoden der Klasse verwenden. Der Verbindungszeichenfolgen-Generator stellt stark typisierte Eigenschaften mit strikter Typbindung bereit, die den bekannten Schlüsselwort-Wert-Paaren entsprechen. Entwickler, die Verbindungszeichenfolgen als Teil von Anwendungen erstellen müssen, können die EntityConnectionStringBuilder-Klasse verwenden, um Verbindungszeichenfolgen zu erstellen und zu ändern.

Der EntityConnectionStringBuilder überprüft auf gültige Schlüsselwort-Wert-Paare, von denen jedes als ein EntityConnectionStringBuilder-Eigenschaftswert verfügbar gemacht wird.

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.

Konstruktoren

EntityConnectionStringBuilder()	Initialisiert eine neue Instanz der EntityConnectionStringBuilder-Klasse.
EntityConnectionStringBuilder(String)	Initialisiert mithilfe der angegebenen Verbindungszeichenfolge eine neue Instanz der EntityConnectionStringBuilder-Klasse.

Eigenschaften

BrowsableConnectionString	Ruft einen Wert ab, der angibt, ob die ConnectionString-Eigenschaft in Visual Studio-Designern sichtbar ist, oder legt diesen Wert fest. (Geerbt von DbConnectionStringBuilder)
ConnectionString	Ruft die dem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von DbConnectionStringBuilder)
Count	Ruft die aktuelle Anzahl von Schlüsseln ab, die in der ConnectionString-Eigenschaft enthalten sind. (Geerbt von DbConnectionStringBuilder)
IsFixedSize	Ruft einen Wert ab, der angibt, ob die EntityConnectionStringBuilder eine feste Größe hat.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die DbConnectionStringBuilder schreibgeschützt ist. (Geerbt von DbConnectionStringBuilder)
Item[String]	Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest. In C# ist diese Eigenschaft der Indexer.
Keys	Ruft eine ICollection ab, die die Schlüssel im EntityConnectionStringBuilder enthält.
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 im Verbindungszeichenfolge ab oder legt den Namen fest.
ProviderConnectionString	Ruft die innere, anbieterspezifische Verbindungszeichenfolge ab oder legt diese fest.
Values	Ruft ein ICollection ab, das die Werte im DbConnectionStringBuilder enthält. (Geerbt von DbConnectionStringBuilder)

Methoden

Add(String, Object)	Fügt dem DbConnectionStringBuilder einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu. (Geerbt von DbConnectionStringBuilder)
Clear()	Löscht den Inhalt der EntityConnectionStringBuilder-Instanz.
ClearPropertyDescriptors()	Löscht die Auflistung von PropertyDescriptor-Objekten, die dem DbConnectionStringBuilder zugeordnet sind. (Geerbt von DbConnectionStringBuilder)
ContainsKey(String)	Stellt fest, ob der EntityConnectionStringBuilder einen bestimmten Schlüssel enthält.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
EquivalentTo(DbConnectionStringBuilder)	Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder-Objekt mit den Verbindungsinformationen im angegebenen Objekt. (Geerbt von DbConnectionStringBuilder)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperties(Hashtable)	Füllt eine angegebene Hashtable mit Informationen zu allen Eigenschaften dieses DbConnectionStringBuilder. (Geerbt von DbConnectionStringBuilder)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(String)	Entfernt den Eintrag mit dem angegebenen Schlüssel aus der EntityConnectionStringBuilder-Instanz.
ShouldSerialize(String)	Gibt an, ob der angegebene Schlüssel in dieser DbConnectionStringBuilder-Instanz vorhanden ist. (Geerbt von DbConnectionStringBuilder)
ToString()	Gibt die diesem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge zurück. (Geerbt von DbConnectionStringBuilder)
TryGetValue(String, Object)	Ruft einen Wert ab, der dem von diesem EntityConnectionStringBuilder bereitgestellten Schlüssel entspricht.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert die Elemente der ICollection in ein Array, beginnend bei einem bestimmten Array-Index. (Geerbt von DbConnectionStringBuilder)
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist. (Geerbt von DbConnectionStringBuilder)
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert werden kann. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Gibt eine Auflistung benutzerdefinierter Attribute für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Gibt den Klassennamen dieser Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Gibt den Namen dieser Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Gibt einen Typkonverter für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Gibt das Standardereignis für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Gibt die Standardeigenschaft für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Gibt einen Editor des angegebenen Typs für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Gibt die Ereignisse für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Gibt die Ereignisse für diese Instanz einer Komponente zurück, wobei das angegebene Attributarray als Filter verwendet wird. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Gibt die Eigenschaften für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Gibt die Eigenschaften für diese Instanz einer Komponente zurück, wobei das Attributarray als Filter verwendet wird. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Gibt ein Objekt zurück, das die Eigenschaft enthält, die durch den Eigenschaftendeskriptor angegeben ist. (Geerbt von DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu. (Geerbt von DbConnectionStringBuilder)
IDictionary.Contains(Object)	Ermittelt, ob das IDictionary-Objekt ein Element mit dem angegebenen Schlüssel enthält. (Geerbt von DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Gibt ein IDictionaryEnumerator-Objekt für das IDictionary-Objekt zurück. (Geerbt von DbConnectionStringBuilder)
IDictionary.Item[Object]	Ruft das Element mit dem angegebenen Schlüssel ab oder legt dieses fest. (Geerbt von DbConnectionStringBuilder)
IDictionary.Remove(Object)	Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary-Objekt. (Geerbt von DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Geerbt von DbConnectionStringBuilder)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Weitere Informationen

• EntityConnection
• Verbindungszeichenfolgen
• Arbeiten mit EntityClient