EntityConnection Klasse

Definition

Enthält einen Verweis auf ein Konzeptmodell und eine Datenquellenverbindung.Contains a reference to a conceptual model and a data source connection. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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

Hinweise

Um zu vermeiden, dass versehentlich Objekte System.Data.Common.CommandTrees wie ObjectContext und nicht mit Ihren Metadaten synchronisiert werden EntityConnection , müssen die zugehörigen Metadaten von Sperren.To avoid inadvertently putting objects such as System.Data.Common.CommandTrees and ObjectContext out of sync with their metadata, EntityConnection must lock its metadata. Nachdem die Metadaten gesperrt sind, sind keine Änderungen an der Verbindungs Zeichenfolge zulässig.No changes to the connection string are allowed after the metadata is locked. Im folgenden finden Sie zwei Szenarien, in denen die Metadaten gesperrt sind:The following are two scenarios in which metadata is locked:

Beim Laden EntityConnection von Metadaten überprüft, ob das konzeptionelle Modell, das Speichermodell und die Mapping-Datei alle vorhanden sind.When metadata is loaded, the EntityConnection verifies that the conceptual model, the storage model, and the mapping file are all present.

Codebeispiele finden Sie unter Arbeiten mit EntityClient.For code examples, see Working with EntityClient.

Konstruktoren

EntityConnection()

Initialisiert eine neue Instanz der EntityConnection-Klasse.Initializes a new instance of the EntityConnection class.

EntityConnection(MetadataWorkspace, DbConnection)

Initialisiert eine neue Instanz der EntityConnection-Klasse mit einem angegebenen MetadataWorkspace und DbConnection.Initializes a new instance of the EntityConnection class with a specified MetadataWorkspace and DbConnection.

EntityConnection(String)

Initialisiert auf Grundlage der Verbindungszeichenfolge eine neue Instanz der EntityConnection-Klasse.Initializes a new instance of the EntityConnection class, based on the connection string.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Geerbt von Component)
ConnectionString

Ruft die EntityConnection-Verbindungszeichenfolge ab oder legt diese fest.Gets or sets the EntityConnection connection string.

ConnectionTimeout

Ruft die Anzahl von Sekunden ab, während der beim Verbindungsaufbau gewartet werden soll, bevor der Versuch beendet und ein Fehler generiert wird.Gets the number of seconds to wait when attempting to establish a connection before ending the attempt and generating an error.

Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Geerbt von Component)
Database

Ruft den Namen der aktuellen Datenbank oder der nach dem Öffnen einer Verbindung verwendeten Datenbank ab.Gets the name of the current database, or the database that will be used after a connection is opened.

DataSource

Ruft den Namen oder die Netzwerkadresse der Datenquelle ab, mit der eine Verbindung hergestellt werden soll.Gets the name or network address of the data source to connect to.

DbProviderFactory

Ruft den DbProviderFactory für diesen DbConnection ab.Gets the DbProviderFactory for this DbConnection.

(Geerbt von DbConnection)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
ServerVersion

Ruft eine Zeichenfolge mit der Version der Datenquelle ab, mit der der Client verbunden ist.Gets a string that contains the version of the data source to which the client is connected.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
State

Ruft die ConnectionState-Eigenschaft des zugrunde liegenden Anbieters ab, wenn die EntityConnection geöffnet ist.Gets the ConnectionState property of the underlying provider if the EntityConnection is open. Andernfalls wird Closedzurückgegeben.Otherwise, returns Closed.

StoreConnection

Bietet Zugriff auf die vom EntityConnection-Objekt verwendete zugrunde liegende Datenquellenverbindung.Provides access to the underlying data source connection that is used by the EntityConnection object.

Methoden

BeginDbTransaction(IsolationLevel)

Startet beim Überschreiben in einer abgeleiteten Klasse eine DatenbanktransaktionWhen overridden in a derived class, starts a database transaction.

(Geerbt von DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Startet asynchron eine DatenbanktransaktionAsynchronously starts a database transaction.

(Geerbt von DbConnection)
BeginTransaction()

Startet eine Transaktion mit dem zugrunde liegenden Anbieter.Begins a transaction by using the underlying provider.

BeginTransaction(IsolationLevel)

Startet eine Transaktion mit dem zugrunde liegenden Anbieter mit der angegebenen Isolationsstufe.Begins a transaction with the specified isolation level by using the underlying provider.

BeginTransactionAsync(CancellationToken)

Startet asynchron eine DatenbanktransaktionAsynchronously begins a database transaction.

(Geerbt von DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

Startet asynchron eine DatenbanktransaktionAsynchronously begins a database transaction.

(Geerbt von DbConnection)
ChangeDatabase(String)

Wird nicht unterstützt.Not supported.

ChangeDatabaseAsync(String, CancellationToken)

Ändert asynchron die aktuelle Datenbank für eine offene VerbindungAsynchronously changes the current database for an open connection.

(Geerbt von DbConnection)
Close()

Schließt die Verbindung mit der Datenbank.Closes the connection to the database.

CloseAsync()

Schließt asynchron die Verbindung mit der DatenbankAsynchronously closes the connection to the database.

(Geerbt von DbConnection)
CreateCommand()

Erstellt eine neue Instanz eines EntityCommand, mit der Connection auf diese EntityConnection festgelegt.Creates a new instance of an EntityCommand, with the Connection set to this EntityConnection.

CreateDbCommand()

Erstellt beim Überschreiben in einer abgeleiteten Klasse ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurückWhen overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose() (Geerbt von DbConnection)
Dispose(Boolean) (Geerbt von DbConnection)
DisposeAsync()

Stellt das Verbindungsobjekt asynchron bereitAsynchronously diposes the connection object.

(Geerbt von DbConnection)
EnlistTransaction(Transaction)

Trägt dieses EntityConnection-Objekt in die angegebene Transaktion ein.Enlists this EntityConnection in the specified transaction.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetMetadataWorkspace()

Gibt den MetadataWorkspace zurück, der dieser EntityConnection zugeordnet ist.Returns the MetadataWorkspace associated with this EntityConnection.

GetSchema()

Gibt Schemainformationen für die Datenquelle dieser DbConnection zurück.Returns schema information for the data source of this DbConnection.

(Geerbt von DbConnection)
GetSchema(String)

Gibt Schemainformationen für die Datenquelle dieser DbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

(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.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

(Geerbt von DbConnection)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Löst das Ereignis StateChange aus.Raises the StateChange event.

(Geerbt von DbConnection)
Open()

Stellt durch das Aufrufen der Open-Methode des zugrunde liegenden Datenanbieters eine Verbindung mit der Datenquelle her.Establishes a connection to the data source by calling the underlying data provider's Open method.

OpenAsync()

Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Einstellungen öffnet, die durch ConnectionString angegeben werden.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Diese Methode ruft die virtuelle Methode OpenAsync(CancellationToken) mit CancellationToken.None auf.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

(Geerbt von DbConnection)
OpenAsync(CancellationToken)

Dies ist die asynchrone Version von Open().This is the asynchronous version of Open(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional berücksichtigt werden.The cancellation token can optionally be honored.

Die Standardimplementierung ruft den asynchronen Open()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück.The default implementation invokes the synchronous Open() call and returns a completed task. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Die Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbConnection-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Geerbt von DbConnection)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Geerbt von Component)

Ereignisse

Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)
StateChange

Tritt ein, wenn der Zustand des Ereignisses geändert wird.Occurs when the state of the event changes.

(Geerbt von DbConnection)

Explizite Schnittstellenimplementierungen

IDbConnection.BeginTransaction()

Beginnt eine Datenbanktransaktion.Begins a database transaction.

(Geerbt von DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe.Begins a database transaction with the specified isolation level.

(Geerbt von DbConnection)
IDbConnection.CreateCommand()

Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt dieses zurück.Creates and returns a DbCommand object that is associated with the current connection.

(Geerbt von DbConnection)

Gilt für:

Siehe auch