EntityConnection Třída

Reference

Definice

Obor názvů:: System.Data.EntityClient

Sestavení:: System.Data.Entity.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Obsahuje odkaz na koncepční model a připojení ke zdroji dat. Tato třída se nemůže dědit.

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

Dědičnost: Object

MarshalByRefObject

Component

DbConnection
EntityConnection

Poznámky

Chcete-li zabránit neúmyslnému uvedení objektů, jako System.Data.Common.CommandTrees jsou a ObjectContext mimo synchronizaci s jejich metadaty, EntityConnection musí uzamknout jejich metadata. Po uzamčení metadat nejsou povoleny žádné změny připojovací řetězec. Tady jsou dva scénáře, ve kterých jsou metadata uzamčena:

Instance EntityConnection je vytvořena prostřednictvím konstruktoru bez parametrů nebo konstruktoruEntityConnection(String), který přijímá připojovací řetězec. V obou případech může být připojovací řetězec před otevřením připojení několikrát změněno. Volání Open nebo GetMetadataWorkspace uzamkne metadata.
Instance je EntityConnection vytvořena prostřednictvím konstruktoru EntityConnection(MetadataWorkspace, DbConnection) , který přijímá MetadataWorkspace a DbConnection. V tomto případě jsou metadata uzamčena v době výstavby. V připojovací řetězec nejsou povolené žádné změny.

Když se načtou metadata, nástroj ověří, EntityConnection že existují koncepční model, model úložiště a soubor mapování.

Příklady kódu najdete v tématu Práce s EntityClient.

Konstruktory

EntityConnection()	Inicializuje novou instanci EntityConnection třídy.
EntityConnection(MetadataWorkspace, DbConnection)	Inicializuje novou instanci EntityConnection třídy se zadanými MetadataWorkspace a DbConnection.
EntityConnection(String)	Inicializuje novou instanci EntityConnection třídy na základě připojovací řetězec.

Vlastnosti

CanCreateBatch	Získá hodnotu, která označuje, zda tato DbConnection instance podporuje DbBatch třídu. (Zděděno od DbConnection)
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
ConnectionString	Získá nebo nastaví EntityConnection připojovací řetězec.
ConnectionTimeout	Získá počet sekund čekání při pokusu o navázání připojení před ukončením pokusu a generování chyby.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
Database	Získá název aktuální databáze nebo databáze, která bude použita po otevření připojení.
DataSource	Získá název nebo síťovou adresu zdroje dat, ke kterému se chcete připojit.
DbProviderFactory	Získá pro DbProviderFactory tento DbConnection. (Zděděno od DbConnection)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
ServerVersion	Získá řetězec, který obsahuje verzi zdroje dat, ke kterému je klient připojen.
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
State	ConnectionState Získá vlastnost základního zprostředkovatele, pokud EntityConnection je otevřená. V opačném případě vrátí hodnotu Closed.
StoreConnection	Poskytuje přístup k podkladovému připojení ke zdroji EntityConnection dat, které objekt používá.

Metody

BeginDbTransaction(IsolationLevel)	Při přepsání v odvozené třídě spustí databázovou transakci. (Zděděno od DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně spustí databázovou transakci. (Zděděno od DbConnection)
BeginTransaction()	Zahájí transakci pomocí základního zprostředkovatele.
BeginTransaction(IsolationLevel)	Zahájí transakci se zadanou úrovní izolace pomocí základního zprostředkovatele.
BeginTransactionAsync(CancellationToken)	Asynchronně zahájí databázovou transakci. (Zděděno od DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně zahájí databázovou transakci. (Zděděno od DbConnection)
ChangeDatabase(String)	Nepodporováno
ChangeDatabaseAsync(String, CancellationToken)	Asynchronně změní aktuální databázi pro otevřené připojení. (Zděděno od DbConnection)
Close()	Ukončí připojení k databázi.
CloseAsync()	Asynchronně ukončí připojení k databázi. (Zděděno od DbConnection)
CreateBatch()	Vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu. (Zděděno od DbConnection)
CreateCommand()	Vytvoří novou instanci objektu EntityCommand, který má nastavenou Connection hodnotu EntityConnection.
CreateDbBatch()	Při přepsání v odvozené třídě vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu. (Zděděno od DbConnection)
CreateDbCommand()	Při přepsání v odvozené třídě vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení. (Zděděno od DbConnection)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbConnection)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbConnection nástrojem a volitelně uvolní spravované prostředky. (Zděděno od DbConnection)
DisposeAsync()	Asynchronně rozdělí objekt připojení. (Zděděno od DbConnection)
EnlistTransaction(Transaction)	Zadává tuto EntityConnection hodnotu do zadané transakce.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetMetadataWorkspace()	Vrátí hodnotu přidruženou MetadataWorkspace k tomuto EntityConnection.
GetSchema()	Vrátí informace o schématu pro zdroj dat tohoto DbConnection. (Zděděno od DbConnection)
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto DbConnection typu pomocí zadaného řetězce pro název schématu. (Zděděno od DbConnection)
GetSchema(String, String[])	Vrátí informace o schématu pro zdroj dat tohoto DbConnection typu pomocí zadaného řetězce pro název schématu a zadaného pole řetězců pro hodnoty omezení. (Zděděno od DbConnection)
GetSchemaAsync(CancellationToken)	Toto je asynchronní verze nástroje GetSchema(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně `cancellationToken` může být ctěna. Výchozí implementace vyvolá synchronní GetSchema() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud již byla předána `cancellationToken`. Výjimky vyvolané nástrojem GetSchema() budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. (Zděděno od DbConnection)
GetSchemaAsync(String, CancellationToken)	Toto je asynchronní verze nástroje GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně `cancellationToken` může být ctěna. Výchozí implementace vyvolá synchronní GetSchema(String) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud již byla předána `cancellationToken`. Výjimky vyvolané nástrojem GetSchema(String) budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. (Zděděno od DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Toto je asynchronní verze nástroje GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně `cancellationToken` může být ctěna. Výchozí implementace vyvolá synchronní GetSchema(String, String[]) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud již byla předána `cancellationToken`. Výjimky vyvolané nástrojem GetSchema(String, String[]) budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. (Zděděno od DbConnection)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	StateChange Vyvolá událost. (Zděděno od DbConnection)
Open()	Vytvoří připojení ke zdroji dat voláním metody zprostředkovatele `Open` podkladových dat.
OpenAsync()	Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením určeným ConnectionStringnástrojem . Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) s CancellationToken.None. (Zděděno od DbConnection)
OpenAsync(CancellationToken)	Toto je asynchronní verze nástroje Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení je možné volitelně respektovat. Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušený úkol, pokud již zrušený cancellationToken. Výjimky vyvolané otevřením budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. Nevyvolávej jiné metody a vlastnosti objektu `DbConnection` , dokud nebude dokončena vrácená úloha. (Zděděno od DbConnection)
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed	Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)
StateChange	Nastane, když se změní stav připojení. (Zděděno od DbConnection)

Explicitní implementace rozhraní

IDbConnection.BeginTransaction()	Zahájí transakci databáze. (Zděděno od DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Zahájí databázi transakce se zadanou úrovní izolace. (Zděděno od DbConnection)
IDbConnection.CreateCommand()	Vytvoří a vrátí DbCommand objekt, který je přidružen k aktuálnímu připojení. (Zděděno od DbConnection)

Platí pro