EntityConnection Klasa

Definicja

Przestrzeń nazw:

System.Data.EntityClient

Zestaw:

System.Data.Entity.dll

Zawiera odwołanie do modelu koncepcyjnego i połączenia ze źródłem danych. Tej klasy nie można dziedziczyć.

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

Dziedziczenie

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

Uwagi

Aby uniknąć nieumyślnego umieszczania obiektów, takich jak System.Data.Common.CommandTrees i ObjectContext poza synchronizacją z ich metadanymi, EntityConnection należy zablokować jego metadane. Po zablokowaniu metadanych nie są dozwolone żadne zmiany w parametry połączenia. Poniżej przedstawiono dwa scenariusze, w których metadane są zablokowane:

• Wystąpienie EntityConnection jest konstruowane za pomocą konstruktora bez parametrów lub za pośrednictwem konstruktora EntityConnection(String), który akceptuje parametry połączenia. W obu przypadkach parametry połączenia można zmienić wiele razy przed otwarciem połączenia. Wywoływanie Open lub GetMetadataWorkspace blokowanie metadanych.

• Wystąpienie EntityConnection jest konstruowane za pomocą konstruktora EntityConnection(MetadataWorkspace, DbConnection) , który akceptuje element MetadataWorkspace i DbConnection. W takim przypadku metadane są blokowane w czasie budowy. Żadne zmiany w parametry połączenia nigdy nie są dozwolone.

Po załadowaniu metadanych sprawdza, EntityConnection czy model koncepcyjny, model magazynu i plik mapowania są obecne.

Przykłady kodu można znaleźć w temacie Working with EntityClient (Praca z obiektem EntityClient).

Konstruktory

Nazwa	Opis
EntityConnection()	Inicjuje nowe wystąpienie klasy EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Inicjuje EntityConnection nowe wystąpienie klasy o określonej MetadataWorkspace wartości i DbConnection.
EntityConnection(String)	Inicjuje nowe wystąpienie klasy EntityConnection na podstawie parametry połączenia.

Właściwości

Nazwa	Opis
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
ConnectionString	Pobiera lub ustawia EntityConnection parametry połączenia.
ConnectionTimeout	Pobiera liczbę sekund oczekiwania podczas próby nawiązania połączenia przed zakończeniem próby i wygenerowaniem błędu.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
Database	Pobiera nazwę bieżącej bazy danych lub bazę danych, która będzie używana po otwarciu połączenia.
DataSource	Pobiera nazwę lub adres sieciowy źródła danych do nawiązania połączenia.
DbProviderFactory	Pobiera element DbProviderFactory dla tego elementu DbConnection. (Odziedziczone po DbConnection)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego elementu Component. (Odziedziczone po Component)
ServerVersion	Pobiera ciąg zawierający wersję źródła danych, z którym jest połączony klient.
Site	Pobiera lub ustawia ISite dla Component. (Odziedziczone po Component)
State	ConnectionState Pobiera właściwość bazowego dostawcy, jeśli EntityConnection jest otwarty. W przeciwnym razie zwraca wartość Closed.
StoreConnection	Zapewnia dostęp do bazowego połączenia źródła danych używanego EntityConnection przez obiekt.

Metody

Nazwa	Opis
BeginDbTransaction(IsolationLevel)	Po zastąpieniu w klasie pochodnej uruchamia transakcję bazy danych. (Odziedziczone po DbConnection)
BeginTransaction()	Rozpoczyna transakcję przy użyciu dostawcy bazowego.
BeginTransaction(IsolationLevel)	Rozpoczyna transakcję z określonym poziomem izolacji przy użyciu bazowego dostawcy.
ChangeDatabase(String)	Niewspierane.
Close()	Zamyka połączenie z bazą danych.
CreateCommand()	Tworzy nowe wystąpienie obiektu EntityCommandz zestawem Connection na wartość EntityConnection.
CreateDbCommand()	Po zastąpieniu w klasie pochodnej tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
EnlistTransaction(Transaction)	Zapisuje to EntityConnection w określonej transakcji.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetMetadataWorkspace()	MetadataWorkspace Zwraca wartość skojarzona z tym EntityConnectionelementem .
GetSchema()	Zwraca informacje o schemacie dla źródła danych tego DbConnectionelementu . (Odziedziczone po DbConnection)
GetSchema(String, String[])	Zwraca informacje o schemacie dla źródła DbConnection danych przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń. (Odziedziczone po DbConnection)
GetSchema(String)	Zwraca informacje o schemacie dla źródła DbConnection danych przy użyciu określonego ciągu dla nazwy schematu. (Odziedziczone po DbConnection)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	StateChange Wywołuje zdarzenie. (Odziedziczone po DbConnection)
Open()	Ustanawia połączenie ze źródłem danych, wywołując metodę bazowego dostawcy Open danych.
OpenAsync()	Asynchroniczna wersja Open()programu , która otwiera połączenie bazy danych z ustawieniami określonymi ConnectionStringprzez . Ta metoda wywołuje metodę OpenAsync(CancellationToken) wirtualną z elementem CancellationToken.None. (Odziedziczone po DbConnection)
OpenAsync(CancellationToken)	Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie honorować. Domyślna implementacja wywołuje wywołanie synchroniczne Open() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane anulowanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. Nie należy wywoływać innych metod i właściwości DbConnection obiektu, dopóki zwrócone zadanie nie zostanie ukończone. (Odziedziczone po DbConnection)
ToString()	Zwraca wartość zawierającą String nazwę Component, jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Nazwa	Opis
Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
StateChange	Występuje, gdy stan połączenia ulegnie zmianie. (Odziedziczone po DbConnection)

Jawne implementacje interfejsu

Nazwa	Opis
IDbConnection.BeginTransaction()	Rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Rozpoczyna transakcję bazy danych z określonym poziomem izolacji. (Odziedziczone po DbConnection)
IDbConnection.CreateCommand()	Tworzy i zwraca DbCommand obiekt skojarzony z bieżącym połączeniem. (Odziedziczone po DbConnection)

Zobacz też

• Dostawca EntityClient dla programu Entity Framework
• Łańcuch połączenia