EntityConnection Konstruktory

Definicja

Przestrzeń nazw:

System.Data.EntityClient

Zestaw:

System.Data.Entity.dll

Inicjuje nowe wystąpienie klasy EntityConnection.

Przeciążenia

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

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ą zablokowane 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.

EntityConnection()

Inicjuje nowe wystąpienie klasy EntityConnection.

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

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ą zablokowane 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.

EntityConnection(String)

Inicjuje EntityConnection nowe wystąpienie klasy na podstawie parametry połączenia.

public:
 EntityConnection(System::String ^ connectionString);

public EntityConnection (string connectionString);

new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnection

Public Sub New (connectionString As String)

Parametry

connectionString

String

Parametry połączenia specyficzne dla dostawcy.

Wyjątki

ArgumentException

Podano nieprawidłowe słowo kluczowe parametry połączenia lub nie podano wymaganego słowa kluczowego parametry połączenia.

Uwagi

Narzędzia modelu danych jednostki generują nazwaną parametry połączenia przechowywaną w pliku konfiguracji aplikacji. Ten nazwany parametry połączenia można podać zamiast parametru connectionStringEntityConnection podczas tworzenia wystąpienia klasy.

Aby uniknąć przypadkowo umieszczania obiektów i ObjectContext synchronizacji z ich metadanymiSystem.Data.Common.CommandTrees, 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 pomocą tego 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ą konstruktoraEntityConnection(MetadataWorkspace, DbConnection), który akceptuje element MetadataWorkspace i .DbConnection W takim przypadku metadane są zablokowane 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.

EntityConnection(MetadataWorkspace, DbConnection)

Inicjuje EntityConnection nowe wystąpienie klasy o określonej wartości MetadataWorkspace i DbConnection.

public:
 EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);

public EntityConnection (System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);

new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnection

Public Sub New (workspace As MetadataWorkspace, connection As DbConnection)

Parametry

workspace

MetadataWorkspace

Element MetadataWorkspace do skojarzenia z tym EntityConnectionelementem .

connection

DbConnection

Podstawowe połączenie źródła danych dla tego EntityConnection obiektu.

Wyjątki

ArgumentNullException

Parametr workspace or connection to null.

ArgumentException

Brak modelu koncepcyjnego w obszarze roboczym.

-lub-

Brak pliku mapowania w obszarze roboczym.

-lub-

Brak modelu magazynu w obszarze roboczym.

-lub-

Element connection nie jest w stanie zamkniętym.

ProviderIncompatibleException

Element connection nie pochodzi z dostawcy zgodnego z platformą Entity Framework ADO.NET.

Uwagi

Ten konstruktor umożliwia utworzenie elementu EntityConnection na podstawie metadanych, które nie pochodzą z pliku na dysku lub z osadzonego zasobu w zestawie.

Aby uniknąć nieumyślnego umieszczania obiektów, takich jak System.Data.Common.CommandTrees i ObjectContext poza synchronizacją z ich metadanymi, EntityConnection element musi 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ą tego konstruktora (EntityConnection(MetadataWorkspace, DbConnection)), który akceptuje element MetadataWorkspace i .DbConnection W takim przypadku metadane są zablokowane 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.