EntityConnection Klasse

Definition

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

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::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 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()	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()	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 Open aufgerufen wird.
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 DbConnection Objekts auf, wenn die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbConnection)
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)

Weitere Informationen

• EntityClient-Anbieter für Entity Framework
• Verbindungszeichenfolge