Freigeben über


EntityConnectionStringBuilder Klasse

Definition

Bietet eine einfache Möglichkeit zum Erstellen und Verwalten des Inhalts von Verbindungszeichenfolgen, die vom EntityClient verwendet werden.

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
EntityConnectionStringBuilder

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der EntityConnectionStringBuilder in Verbindung mit einem 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();
}
' 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

Mit dem Verbindungszeichenfolgen-Generator können Entwickler syntaktisch korrekte Verbindungszeichenfolgen erstellen und vorhandene Verbindungszeichenfolgen mithilfe von Eigenschaften und Methoden der Klasse analysieren und neu erstellen. Der Verbindungszeichenfolgen-Generator stellt stark typierte Eigenschaften 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.

Die EntityConnectionStringBuilder Ausführung führt Überprüfungen auf gültige Schlüsselwort-Wert-Paare durch, die jeweils als EntityConnectionStringBuilder Eigenschaftswert verfügbar gemacht werden.

Hinweis

Die Verbindungszeichenfolge für die zugrunde liegende Datenquelle wird von der ProviderConnectionString Eigenschaft bereitgestellt. Die angegebene Anbieterverbindungszeichenfolge wird nicht auf gültige Schlüsselwort-Wert-Paare überprüft.

Konstruktoren

Name Beschreibung
EntityConnectionStringBuilder()

Initialisiert eine neue Instanz der EntityConnectionStringBuilder-Klasse.

EntityConnectionStringBuilder(String)

Initialisiert eine neue Instanz der Klasse mithilfe der EntityConnectionStringBuilder angegebenen Verbindungszeichenfolge.

Eigenschaften

Name Beschreibung
BrowsableConnectionString

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die ConnectionString Eigenschaft in Visual Studio-Designern sichtbar ist.

(Geerbt von DbConnectionStringBuilder)
ConnectionString

Dient zum Abrufen oder Festlegen der Verbindungszeichenfolge, die der DbConnectionStringBuilder.

(Geerbt von DbConnectionStringBuilder)
Count

Ruft die aktuelle Anzahl der Schlüssel 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 aufweist.

IsReadOnly

Ruft einen Wert ab, der angibt, ob die DbConnectionStringBuilder schreibgeschützt ist.

(Geerbt von DbConnectionStringBuilder)
Item[String]

Dient zum Abrufen oder Festlegen des Werts, der dem angegebenen Schlüssel zugeordnet ist. In C# ist diese Eigenschaft der Indexer.

Keys

Ruft ein ICollection , das die Schlüssel in der EntityConnectionStringBuilder.

Metadata

Dient zum Abrufen oder Festlegen der Metadatenspeicherorte in der Verbindungszeichenfolge.

Name

Ruft den Namen eines Abschnitts ab, der in einer Konfigurationsdatei definiert ist, oder legt den Namen fest.

Provider

Dient zum Abrufen oder Festlegen des Namens des zugrunde liegenden .NET Framework-Datenanbieters in der Verbindungszeichenfolge.

ProviderConnectionString

Dient zum Abrufen oder Festlegen der inneren, anbieterspezifischen Verbindungszeichenfolge.

Values

Ruft eine ICollection , die die Werte in der DbConnectionStringBuilder.

(Geerbt von DbConnectionStringBuilder)

Methoden

Name Beschreibung
Add(String, Object)

Fügt dem angegebenen Schlüssel und Wert DbConnectionStringBuildereinen Eintrag hinzu.

(Geerbt von DbConnectionStringBuilder)
Clear()

Löscht den Inhalt der EntityConnectionStringBuilder Instanz.

ClearPropertyDescriptors()

Löscht die Auflistung von PropertyDescriptor Objekten für die zugeordnete DbConnectionStringBuilder.

(Geerbt von DbConnectionStringBuilder)
ContainsKey(String)

Bestimmt, ob der EntityConnectionStringBuilder Schlüssel einen bestimmten Schlüssel enthält.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
EquivalentTo(DbConnectionStringBuilder)

Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder Objekt mit den Verbindungsinformationen im angegebenen Objekt.

(Geerbt von DbConnectionStringBuilder)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetProperties(Hashtable)

Füllt eine bereitgestellte Hashtable Information über alle Eigenschaften dieser DbConnectionStringBuilder.

(Geerbt von DbConnectionStringBuilder)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der 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 DbConnectionStringBuilderZugeordnete Verbindungszeichenfolge zurück.

(Geerbt von DbConnectionStringBuilder)
TryGetValue(String, Object)

Ruft einen Wert ab, der dem angegebenen Schlüssel entspricht EntityConnectionStringBuilder.

Explizite Schnittstellenimplementierungen

Name Beschreibung
ICollection.CopyTo(Array, Int32)

Kopiert die Elemente des Elements in ICollection 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 Synchronisierung (Threadsicher) erfolgt.

(Geerbt von DbConnectionStringBuilder)
ICollection.SyncRoot

Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die ICollectionverwendet werden kann.

(Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()

Gibt eine Auflistung von benutzerdefinierten Attributen 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, die das angegebene Attributarray als Filter verwendet.

(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, die das Attributarray als Filter verwendet.

(Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Gibt ein Objekt zurück, das die durch den angegebenen Eigenschaftsdeskriptor beschriebene Eigenschaft enthält.

(Geerbt von DbConnectionStringBuilder)
IDictionary.Add(Object, Object)

Fügt dem Objekt ein Element mit dem bereitgestellten Schlüssel und Wert hinzu IDictionary .

(Geerbt von DbConnectionStringBuilder)
IDictionary.Contains(Object)

Bestimmt, 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 es 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

Name Beschreibung
AsParallel(IEnumerable)

Aktiviert die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Wandelt eine IEnumerable in eine IQueryableum.

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.

OfType<TResult>(IEnumerable)

Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

Gilt für:

Weitere Informationen