EntityConnection Klasse

Definition

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Enthält einen Verweis auf ein Konzeptmodell und eine Datenquellenverbindung. Diese Klasse kann nicht vererbt werden.

public ref class EntityConnection sealed : System::Data::Common::DbConnection

public sealed class EntityConnection : System.Data.Common.DbConnection

type EntityConnection = class
    inherit DbConnection

Public NotInheritable Class EntityConnection
Inherits DbConnection

Vererbung

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

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 am Verbindungszeichenfolge zulässig. Im Folgenden sind zwei Szenarien aufgeführt, in denen Metadaten gesperrt sind:

• Die EntityConnection instance 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 sperren Sie GetMetadataWorkspace die Metadaten.

• Die EntityConnection instance wird über den -Konstruktor erstellt, der EntityConnection(MetadataWorkspace, DbConnection) ein MetadataWorkspace und ein DbConnectionakzeptiert. In diesem Fall werden die Metadaten zur Erstellungszeit gesperrt. Es sind keine Änderungen am 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.

Konstruktoren

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

Eigenschaften

CanCreateBatch	Ruft einen Wert ab, der angibt, ob diese DbConnection-Instanz die DbBatch-Klasse unterstützt (Geerbt von DbConnection)
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
ConnectionString	Ruft die EntityConnection-Verbindungszeichenfolge ab oder legt diese fest.
ConnectionTimeout	Ruft die Anzahl von Sekunden ab, während der beim Verbindungsaufbau gewartet werden soll, bevor der Versuch beendet und ein Fehler generiert wird.
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
Database	Ruft den Namen der aktuellen Datenbank oder der nach dem Öffnen einer Verbindung verwendeten Datenbank ab.
DataSource	Ruft den Namen oder die Netzwerkadresse der Datenquelle ab, mit der eine Verbindung hergestellt werden soll.
DbProviderFactory	Ruft den DbProviderFactory für diesen DbConnection ab. (Geerbt von DbConnection)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
ServerVersion	Ruft eine Zeichenfolge mit der Version der Datenquelle ab, mit der der Client verbunden ist.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
State	Ruft die ConnectionState-Eigenschaft des zugrunde liegenden Anbieters ab, wenn die EntityConnection geöffnet ist. Andernfalls wird Closedzurückgegeben.
StoreConnection	Bietet Zugriff auf die vom EntityConnection-Objekt verwendete zugrunde liegende Datenquellenverbindung.

Methoden

BeginDbTransaction(IsolationLevel)	Startet beim Überschreiben in einer abgeleiteten Klasse eine Datenbanktransaktion (Geerbt von DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Startet asynchron eine Datenbanktransaktion (Geerbt von DbConnection)
BeginTransaction()	Startet eine Transaktion mit dem zugrunde liegenden Anbieter.
BeginTransaction(IsolationLevel)	Startet eine Transaktion mit dem zugrunde liegenden Anbieter mit der angegebenen Isolationsstufe.
BeginTransactionAsync(CancellationToken)	Startet asynchron eine Datenbanktransaktion (Geerbt von DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Startet asynchron eine Datenbanktransaktion (Geerbt von DbConnection)
ChangeDatabase(String)	Wird nicht unterstützt.
ChangeDatabaseAsync(String, CancellationToken)	Ändert asynchron die aktuelle Datenbank für eine offene Verbindung (Geerbt von DbConnection)
Close()	Schließt die Verbindung mit der Datenbank.
CloseAsync()	Schließt asynchron die Verbindung mit der Datenbank (Geerbt von DbConnection)
CreateBatch()	Gibt eine neue Instanz der Klasse des Anbieters zurück, die die DbBatch-Klasse implementiert. (Geerbt von DbConnection)
CreateCommand()	Erstellt eine neue Instanz eines EntityCommand, mit der Connection auf diese EntityConnection festgelegt.
CreateDbBatch()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine neue instance der Klasse des Anbieters zurück, die die DbBatch Klasse implementiert. (Geerbt von DbConnection)
CreateDbCommand()	Erstellt beim Überschreiben in einer abgeleiteten Klasse ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurück (Geerbt von DbConnection)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von DbConnection)
Dispose(Boolean)	Gibt die von DbConnection verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DbConnection)
DisposeAsync()	Stellt das Verbindungsobjekt asynchron bereit (Geerbt von DbConnection)
EnlistTransaction(Transaction)	Trägt dieses EntityConnection-Objekt in die angegebene Transaktion ein.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetMetadataWorkspace()	Gibt den MetadataWorkspace zurück, der dieser EntityConnection zugeordnet ist.
GetSchema()	Gibt Schemainformationen für die Datenquelle dieser DbConnection zurück. (Geerbt von DbConnection)
GetSchema(String)	Gibt Schemainformationen für die Datenquelle dieser DbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück. (Geerbt von DbConnection)
GetSchema(String, String[])	Gibt Schemainformationen für die Datenquelle dieser DbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens und des angegebenen Zeichenfolgenarrays der Einschränkungswerte zurück. (Geerbt von DbConnection)
GetSchemaAsync(CancellationToken)	Dies ist eine asynchrone Version von GetSchema(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchema()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchema() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. (Geerbt von DbConnection)
GetSchemaAsync(String, CancellationToken)	Dies ist die asynchrone Version von GetSchema(String). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchema(String)-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchema(String) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. (Geerbt von DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Dies ist die asynchrone Version von GetSchema(String, String[]). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchema(String, String[])-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchema(String, String[]) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. (Geerbt von DbConnection)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Löst das StateChange-Ereignis aus. (Geerbt von DbConnection)
Open()	Stellt durch das Aufrufen der Open-Methode des zugrunde liegenden Datenanbieters eine Verbindung mit der Datenquelle her.
OpenAsync()	Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Einstellungen öffnet, die durch ConnectionString angegeben werden. Diese Methode ruft die virtuelle Methode OpenAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbConnection)
OpenAsync(CancellationToken)	Dies ist die asynchrone Version von Open(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen Open()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten hat. Die Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbConnection-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbConnection)
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
StateChange	Tritt auf, wenn sich der Status der Verbindung ändert. (Geerbt von DbConnection)

Explizite Schnittstellenimplementierungen

IDbConnection.BeginTransaction()	Beginnt eine Datenbanktransaktion. (Geerbt von DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe. (Geerbt von DbConnection)
IDbConnection.CreateCommand()	Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt dieses zurück. (Geerbt von DbConnection)

Weitere Informationen

• EntityClient-Anbieter für Entity Framework
• Arbeiten mit EntityClient
• Verbindungszeichenfolge