EntityConnection Konstruktoren

Definition

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Initialisiert eine neue Instanz der EntityConnection-Klasse.

Überlädt

EntityConnection()	Initialisiert eine neue Instanz der EntityConnection-Klasse.
EntityConnection(String)	Initialisiert auf Grundlage der Verbindungszeichenfolge eine neue Instanz der EntityConnection-Klasse.
EntityConnection(MetadataWorkspace, DbConnection)	Initialisiert eine neue Instanz der EntityConnection-Klasse mit einer angegebenen MetadataWorkspace und DbConnection.

Hinweise

Um zu vermeiden, dass Objekte wie System.Data.Common.CommandTrees und ObjectContext nicht versehentlich mit ihren Metadaten synchronisiert werden, EntityConnection müssen die Metadaten gesperrt werden. Nach dem Sperren der Metadaten sind keine Änderungen an der Verbindungszeichenfolge zulässig. Im Folgenden sind zwei Szenarien aufgeführt, in denen Metadaten gesperrt sind:

• Die EntityConnection -Instanz wird über den parameterlosen Konstruktor oder über den Konstruktor erstellt, der EntityConnection(String) eine Verbindungszeichenfolge akzeptiert. In beiden Fällen kann die Verbindungszeichenfolge mehrmals geändert werden, bevor die Verbindung geöffnet wird. Durch aufrufen Open oder GetMetadataWorkspace sperren Sie die Metadaten.

• Die EntityConnection -Instanz wird über den Konstruktor erstellt, der EntityConnection(MetadataWorkspace, DbConnection) ein MetadataWorkspace und ein DbConnectionakzeptiert. In diesem Fall sind die Metadaten zur Bauzeit gesperrt. Es sind keine Änderungen an der Verbindungszeichenfolge zulässig.

Beim Laden von Metadaten wird überprüft, EntityConnection ob das konzeptionelle Modell, das Speichermodell und die Zuordnungsdatei vorhanden sind.

Codebeispiele finden Sie unter Arbeiten mit EntityClient.

EntityConnection()

Initialisiert eine neue Instanz der EntityConnection-Klasse.

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

Hinweise

Um zu vermeiden, dass Objekte wie System.Data.Common.CommandTrees und ObjectContext nicht versehentlich mit ihren Metadaten synchronisiert werden, EntityConnection müssen die Metadaten gesperrt werden. Nach dem Sperren der Metadaten sind keine Änderungen an der Verbindungszeichenfolge zulässig. Im Folgenden sind zwei Szenarien aufgeführt, in denen Metadaten gesperrt sind:

• Die EntityConnection -Instanz wird über den parameterlosen Konstruktor oder über den Konstruktor erstellt, der EntityConnection(String) eine Verbindungszeichenfolge akzeptiert. In beiden Fällen kann die Verbindungszeichenfolge mehrmals geändert werden, bevor die Verbindung geöffnet wird. Durch aufrufen Open oder GetMetadataWorkspace sperren Sie die Metadaten.

• Die EntityConnection -Instanz wird über den Konstruktor erstellt, der EntityConnection(MetadataWorkspace, DbConnection) ein MetadataWorkspace und ein DbConnectionakzeptiert. In diesem Fall sind die Metadaten zur Bauzeit gesperrt. Es sind keine Änderungen an der Verbindungszeichenfolge zulässig.

Beim Laden von Metadaten wird überprüft, EntityConnection ob das konzeptionelle Modell, das Speichermodell und die Zuordnungsdatei vorhanden sind.

Codebeispiele finden Sie unter Arbeiten mit EntityClient.

EntityConnection(String)

Initialisiert auf Grundlage der Verbindungszeichenfolge eine neue Instanz der EntityConnection-Klasse.

public:
 EntityConnection(System::String ^ connectionString);

public EntityConnection (string connectionString);

new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnection

Public Sub New (connectionString As String)

Parameter

connectionString

String

Die anbieterspezifische Verbindungszeichenfolge.

Ausnahmen

ArgumentException

Es wurde ein ungültiges Schlüsselwort für eine Verbindungszeichenfolge bereitgestellt, oder ein erforderliches Schlüsselwort für eine Verbindungszeichenfolge wurde nicht bereitgestellt.

Hinweise

Die Entity Data Model-Tools generieren eine benannte Verbindungszeichenfolge, die in der Konfigurationsdatei der Anwendung gespeichert ist. Diese benannte Verbindungszeichenfolge kann anstelle des connectionString Parameters angegeben werden, wenn Sie die EntityConnection Klasse instanziieren.

Um zu vermeiden, dass Objekte System.Data.Common.CommandTreesObjectContext versehentlich und nicht mit ihren Metadaten synchronisiert werden, EntityConnection müssen die Metadaten gesperrt werden. Nach dem Sperren der Metadaten sind keine Änderungen an der Verbindungszeichenfolge zulässig. Im Folgenden sind zwei Szenarien aufgeführt, in denen Metadaten gesperrt sind:

• Die EntityConnection -Instanz wird über den parameterlosen Konstruktor oder über diesen Konstruktor (EntityConnection(String)) erstellt, der eine Verbindungszeichenfolge akzeptiert. In beiden Fällen kann die Verbindungszeichenfolge mehrmals geändert werden, bevor die Verbindung geöffnet wird. Durch aufrufen Open oder GetMetadataWorkspace sperren Sie die Metadaten.

• Die EntityConnection -Instanz wird über den Konstruktor erstellt, der EntityConnection(MetadataWorkspace, DbConnection) ein MetadataWorkspace und ein DbConnectionakzeptiert. In diesem Fall sind die Metadaten zur Bauzeit gesperrt. Es sind keine Änderungen an der Verbindungszeichenfolge zulässig.

Beim Laden von Metadaten wird überprüft, EntityConnection ob das konzeptionelle Modell, das Speichermodell und die Zuordnungsdatei vorhanden sind.

Codebeispiele finden Sie unter Arbeiten mit EntityClient.

EntityConnection(MetadataWorkspace, DbConnection)

Initialisiert eine neue Instanz der EntityConnection-Klasse mit einer angegebenen MetadataWorkspace und DbConnection.

public:
 EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);

public EntityConnection (System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);

new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnection

Public Sub New (workspace As MetadataWorkspace, connection As DbConnection)

Parameter

workspace

MetadataWorkspace

Ein MetadataWorkspace, das EntityConnection zugeordnet werden soll.

connection

DbConnection

Die zugrunde liegende Datenquellenverbindung für dieses EntityConnection-Objekt.

Ausnahmen

ArgumentNullException

Der workspace-Parameter oder der connection-Parameter ist null.

ArgumentException

Das konzeptionelle Modell fehlt im Arbeitsbereich.

- oder -

Die Zuordnungsdatei fehlt im Arbeitsbereich.

- oder -

Das Speichermodell fehlt im Arbeitsbereich.

- oder -

Das connection-Element befindet sich nicht im geschlossenen Zustand.

ProviderIncompatibleException

Der connection stammt nicht von einem ADO.NET Entity Framework-kompatiblen Anbieter.

Hinweise

Mit diesem Konstruktor können Sie aus EntityConnection Metadaten erstellen, die nicht aus einer Datei auf einem Datenträger oder einer eingebetteten Ressource in einer Assembly stammen.

Um zu vermeiden, dass Objekte wie System.Data.Common.CommandTrees und ObjectContext nicht versehentlich mit ihren Metadaten synchronisiert werden, muss die EntityConnection seine Metadaten sperren. Nach dem Sperren der Metadaten sind keine Änderungen an der Verbindungszeichenfolge zulässig. Im Folgenden sind zwei Szenarien aufgeführt, in denen Metadaten gesperrt sind:

• Die EntityConnection -Instanz wird über den parameterlosen Konstruktor oder über den Konstruktor erstellt, der EntityConnection(String) eine Verbindungszeichenfolge akzeptiert. In beiden Fällen kann die Verbindungszeichenfolge mehrmals geändert werden, bevor die Verbindung geöffnet wird. Durch aufrufen Open oder GetMetadataWorkspace sperren Sie die Metadaten.

• Die EntityConnection -Instanz wird über diesen Konstruktor () erstellt,EntityConnection(MetadataWorkspace, DbConnection) der ein MetadataWorkspace und ein DbConnectionakzeptiert. In diesem Fall sind die Metadaten zur Bauzeit gesperrt. Es sind keine Änderungen an der Verbindungszeichenfolge zulässig.

Beim Laden von Metadaten wird überprüft, EntityConnection ob das konzeptionelle Modell, das Speichermodell und die Zuordnungsdatei vorhanden sind.