EntityConnection Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Enthält einen Verweis auf ein konzeptionelles Modell und eine Datenquellenverbindung. Diese Klasse kann nicht vererbt werden.
public ref class EntityConnection sealed : System::Data::Common::DbConnectionpublic sealed class EntityConnection : System.Data.Common.DbConnectiontype EntityConnection = class
inherit DbConnectionPublic NotInheritable Class EntityConnection
Inherits DbConnection- Vererbung
Hinweise
Um zu vermeiden, dass Objekte wie System.Data.Common.CommandTrees z. B. und ObjectContext nicht mehr mit ihren Metadaten synchronisiert werden, EntityConnection müssen sie die Metadaten sperren. Nach dem Sperren der Metadaten sind keine Änderungen an der Verbindungszeichenfolge zulässig. Es folgen zwei Szenarien, in denen Metadaten gesperrt sind:
Die instanz EntityConnection wird über den parameterlosen Konstruktor oder über den EntityConnection(String)-Konstruktor erstellt, der eine Verbindungszeichenfolge akzeptiert. In beiden Fällen kann die Verbindungszeichenfolge mehrmals geändert werden, bevor die Verbindung geöffnet wird. Das Aufrufen Open oder GetMetadataWorkspace Sperren der Metadaten.
Die EntityConnection Instanz wird über den EntityConnection(MetadataWorkspace, DbConnection) Konstruktor erstellt, der ein MetadataWorkspace und ein DbConnection. In diesem Fall werden 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.
Konstruktoren
| Name | Beschreibung |
|---|---|
| EntityConnection() |
Initialisiert eine neue Instanz der EntityConnection-Klasse. |
| EntityConnection(MetadataWorkspace, DbConnection) |
Initialisiert eine neue Instanz der EntityConnection Klasse mit einem angegebenen MetadataWorkspace und DbConnection. |
| EntityConnection(String) |
Initialisiert eine neue Instanz der klasse EntityConnection basierend auf dem Verbindungszeichenfolge. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanRaiseEvents |
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
| ConnectionString |
Dient zum Abrufen oder Festlegen des EntityConnection Verbindungszeichenfolge. |
| ConnectionTimeout |
Ruft die Anzahl der Sekunden ab, die gewartet werden soll, wenn versucht wird, eine Verbindung herzustellen, bevor der Versuch beendet und ein Fehler generiert wird. |
| Container |
Ruft das, das IContainer die Component. (Geerbt von Component) |
| Database |
Ruft den Namen der aktuellen Datenbank oder die Datenbank ab, die nach dem Öffnen einer Verbindung verwendet wird. |
| DataSource |
Ruft den Namen oder die Netzwerkadresse der Datenquelle ab, mit der eine Verbindung hergestellt werden soll. |
| DbProviderFactory |
Ruft dies DbProviderFactoryDbConnectionab. (Geerbt von DbConnection) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet. (Geerbt von Component) |
| Events |
Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component) |
| ServerVersion |
Ruft eine Zeichenfolge ab, die die Version der Datenquelle enthält, 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 dies EntityConnection geöffnet ist. Andernfalls wird Closedzurückgegeben. |
| StoreConnection |
Bietet Zugriff auf die zugrunde liegende Datenquellenverbindung, die vom EntityConnection Objekt verwendet wird. |
Methoden
| Name | Beschreibung |
|---|---|
| BeginDbTransaction(IsolationLevel) |
Wenn eine abgeleitete Klasse überschrieben wird, wird eine Datenbanktransaktion gestartet. (Geerbt von DbConnection) |
| BeginTransaction() |
Beginnt eine Transaktion mithilfe des zugrunde liegenden Anbieters. |
| BeginTransaction(IsolationLevel) |
Beginnt eine Transaktion mit der angegebenen Isolationsebene mithilfe des zugrunde liegenden Anbieters. |
| ChangeDatabase(String) |
Nicht unterstützt. |
| Close() |
Schließt die Verbindung mit der Datenbank. |
| CreateCommand() |
Erstellt eine neue Instanz eines EntityCommand, mit dem Connection Satz auf diese EntityConnection. |
| CreateDbCommand() |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein DbCommand Objekt erstellt und zurückgegeben, das der aktuellen Verbindung zugeordnet ist. (Geerbt von DbConnection) |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| EnlistTransaction(Transaction) |
Listet dies EntityConnection in der angegebenen Transaktion auf. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als die Standard-Hashfunktion (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetMetadataWorkspace() |
Gibt den MetadataWorkspace zugeordneten Wert zurück EntityConnection. |
| GetSchema() |
Gibt Schemainformationen für die Datenquelle dieses Werts DbConnectionzurück. (Geerbt von DbConnection) |
| GetSchema(String, String[]) |
Gibt Schemainformationen für die Datenquelle zurück DbConnection , die die angegebene Zeichenfolge für den Schemanamen und das angegebene Zeichenfolgenarray für die Einschränkungswerte verwendet. (Geerbt von DbConnection) |
| GetSchema(String) |
Gibt Schemainformationen für die Datenquelle zurück DbConnection , die die angegebene Zeichenfolge für den Schemanamen verwendet. (Geerbt von DbConnection) |
| GetService(Type) |
Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der 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 eine Verbindung mit der Datenquelle her, indem die Methode des zugrunde liegenden Datenanbieters |
| OpenAsync() |
Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den einstellungen öffnet, die durch die ConnectionString. 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 geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen Open() Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes cancellationToken übergeben wurde. Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Rufen Sie erst andere Methoden und Eigenschaften des |
| ToString() |
Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component) |
| StateChange |
Tritt auf, wenn sich der Status der Verbindung ändert. (Geerbt von DbConnection) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IDbConnection.BeginTransaction() |
Beginnt eine Datenbanktransaktion. (Geerbt von DbConnection) |
| IDbConnection.BeginTransaction(IsolationLevel) |
Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe. (Geerbt von DbConnection) |
| IDbConnection.CreateCommand() |
Erstellt und gibt ein DbCommand Objekt zurück, das der aktuellen Verbindung zugeordnet ist. (Geerbt von DbConnection) |
