EntityConnection Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zawiera odwołanie do modelu koncepcyjnego i połączenia źródła danych. Klasa ta nie może być dziedziczona.
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
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 konstruktoraEntityConnection(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ą konstruktoraEntityConnection(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.
Aby zapoznać się z przykładami kodu, zobacz Praca z elementem EntityClient.
Konstruktory
EntityConnection() |
Inicjuje nowe wystąpienie klasy EntityConnection. |
EntityConnection(MetadataWorkspace, DbConnection) |
Inicjuje EntityConnection nowe wystąpienie klasy o określonej wartości MetadataWorkspace i DbConnection. |
EntityConnection(String) |
Inicjuje EntityConnection nowe wystąpienie klasy na podstawie parametry połączenia. |
Właściwości
CanCreateBatch |
Pobiera wartość wskazującą, czy to DbConnection wystąpienie obsługuje klasę DbBatch . (Odziedziczone po DbConnection) |
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 pliku 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 Componentelementu . (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 element .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, które jest używane przez EntityConnection obiekt. |
Metody
BeginDbTransaction(IsolationLevel) |
Po zastąpieniu klasy pochodnej uruchamia transakcję bazy danych. (Odziedziczone po DbConnection) |
BeginDbTransactionAsync(IsolationLevel, CancellationToken) |
Asynchronicznie 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 podstawowego dostawcy. |
BeginTransactionAsync(CancellationToken) |
Asynchronicznie rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection) |
BeginTransactionAsync(IsolationLevel, CancellationToken) |
Asynchronicznie rozpoczyna transakcję bazy danych. (Odziedziczone po DbConnection) |
ChangeDatabase(String) |
Nieobsługiwane. |
ChangeDatabaseAsync(String, CancellationToken) |
Asynchronicznie zmienia bieżącą bazę danych dla otwartego połączenia. (Odziedziczone po DbConnection) |
Close() |
Zamyka połączenie z bazą danych. |
CloseAsync() |
Asynchronicznie zamyka połączenie z bazą danych. (Odziedziczone po DbConnection) |
CreateBatch() |
Zwraca nowe wystąpienie klasy dostawcy, która implementuje klasę DbBatch . (Odziedziczone po DbConnection) |
CreateCommand() |
Tworzy nowe wystąpienie klasy EntityCommand, z ustawionym Connection na wartość EntityConnection. |
CreateDbBatch() |
Po zastąpieniu klasy pochodnej zwraca nowe wystąpienie klasy dostawcy, które implementuje klasę DbBatch . (Odziedziczone po DbConnection) |
CreateDbCommand() |
Po zastąpieniu klasy 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) |
Dispose() |
Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych. (Odziedziczone po DbConnection) |
Dispose(Boolean) |
Zwalnia zasoby niezarządzane używane przez element DbConnection i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbConnection) |
DisposeAsync() |
Asynchronicznie dysponuje obiekt połączenia. (Odziedziczone po DbConnection) |
EnlistTransaction(Transaction) |
Enlists 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() |
Przestarzałe.
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) |
Zwraca informacje o schemacie dla źródła DbConnection danych przy użyciu określonego ciągu nazwy schematu. (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) |
GetSchemaAsync(CancellationToken) |
Jest to asynchroniczna wersja programu GetSchema().
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetSchemaAsync(String, CancellationToken) |
Jest to asynchroniczna wersja programu GetSchema(String).
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetSchemaAsync(String, String[], CancellationToken) |
Jest to asynchroniczna wersja programu GetSchema(String, String[]).
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetService(Type) |
Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject) |
OnStateChange(StateChangeEventArgs) |
StateChange Zgłasza zdarzenie. (Odziedziczone po DbConnection) |
Open() |
Ustanawia połączenie ze źródłem danych przez wywołanie metody bazowego dostawcy |
OpenAsync() |
Asynchroniczna wersja programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez ConnectionStringelement . 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ątku zadania. Nie należy wywoływać innych metod i właściwości |
ToString() |
Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component) |
Zdarzenia
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
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) |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla