EntityConnection Třída

Definice

Obor názvů:

System.Data.EntityClient

Sestavení:

System.Data.Entity.dll

Obsahuje odkaz na koncepční model a připojení ke zdroji dat. Tuto třídu nelze zdě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

Aby nedocházelo k neúmyslnému vkládání objektů, jako System.Data.Common.CommandTrees jsou a ObjectContext které se nesynchronizují s metadaty, EntityConnection musí svá metadata uzamknout. Po uzamčení metadat nejsou povoleny žádné změny připojovací řetězec. Následují dva scénáře, ve kterých jsou metadata uzamčena:

• Instance EntityConnection je vytvořena prostřednictvím konstruktoru bez parametrů nebo prostřednictvím konstruktoru EntityConnection(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ěn. Volání Open nebo GetMetadataWorkspace uzamčení metadat.

• Instance EntityConnection je vytvořena prostřednictvím konstruktoruEntityConnection(MetadataWorkspace, DbConnection), který přijímá a MetadataWorkspace a .DbConnection V tomto případě jsou metadata v době výstavby uzamčena. Nikdy nejsou povoleny žádné změny připojovací řetězec.

Při načtení metadat ověří, EntityConnection že se nachází koncepční model, model úložiště a soubor mapování.

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

Konstruktory

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

Vlastnosti

Name	Description
CanRaiseEvents	Získá hodnotu urč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á ten IContainer , který obsahuje Component. (Zděděno od Component)
Database	Získá název aktuální databáze nebo databázi, která se použije po otevření připojení.
DataSource	Získá název nebo síťovou adresu zdroje dat pro připojení.
DbProviderFactory	DbProviderFactory Získá pro to DbConnection. (Zděděno od DbConnection)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (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 objektu 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 dat, které objekt používá EntityConnection .

Metody

Name	Description
BeginDbTransaction(IsolationLevel)	Při přepsání v odvozené třídě, spustí databázové transakce. (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.
ChangeDatabase(String)	Nepodporováno.
Close()	Zavře připojení k databázi.
CreateCommand()	Vytvoří novou instanci objektu EntityCommand, s nastavenou Connection na tuto EntityConnectionhodnotu .
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 serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
EnlistTransaction(Transaction)	Zapsá do EntityConnection zadané transakce.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetMetadataWorkspace()	Vrátí přidruženou MetadataWorkspace k tomuto EntityConnection.
GetSchema()	Vrátí informace o schématu pro zdroj dat tohoto DbConnectionobjektu . (Zděděno od DbConnection)
GetSchema(String, String[])	Vrátí informace o schématu pro zdroj dat tohoto DbConnection pomocí zadaného řetězce pro název schématu a zadané pole řetězců pro hodnoty omezení. (Zděděno od DbConnection)
GetSchema(String)	Vrátí informace o schématu pro zdroj dat tohoto DbConnection pomocí zadaného řetězce pro název schématu. (Zděděno od DbConnection)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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 podkladových Open dat.
OpenAsync()	Asynchronní verze Open(), která otevře připojení databáze s nastavením určeným ConnectionString. Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbConnection)
OpenAsync(CancellationToken)	Toto je asynchronní verze Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení lze volitelně respektovat. Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již bylo zrušeno cancellationToken. Výjimky vyvolané příkazem Open budou oznámeny prostřednictvím vrácené vlastnosti Exception úkolu. Nevyvolejte jiné metody a vlastnosti objektu DbConnection , dokud nebude vrácena úloha dokončena. (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

Name	Description
Disposed	Nastane, když komponenta je uvolně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í

Name	Description
IDbConnection.BeginTransaction()	Začne databázovou transakci. (Zděděno od DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Zahájí transakci databáze se zadanou úrovní izolace. (Zděděno od DbConnection)
IDbConnection.CreateCommand()	Vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení. (Zděděno od DbConnection)

Viz také

• Zprostředkovatel EntityClient pro Entity Framework
• Připojovací řetězec