EntityConnection Konstruktor

Definisi

Ruang nama:

System.Data.EntityClient

Rakitan:

System.Data.Entity.dll

Menginisialisasi instans baru kelas EntityConnection.

Overload

EntityConnection()	Menginisialisasi instans baru kelas EntityConnection.
EntityConnection(String)	Menginisialisasi instans EntityConnection baru kelas, berdasarkan string koneksi.
EntityConnection(MetadataWorkspace, DbConnection)	Menginisialisasi instans EntityConnection baru kelas dengan dan DbConnectionyang ditentukanMetadataWorkspace.

Keterangan

Untuk menghindari secara tidak sengaja menempatkan objek seperti System.Data.Common.CommandTrees dan ObjectContext tidak sinkron dengan metadatanya, EntityConnection harus mengunci metadatanya. Tidak ada perubahan pada string koneksi yang diizinkan setelah metadata dikunci. Berikut ini adalah dua skenario di mana metadata dikunci:

• Instans EntityConnection dibangun melalui konstruktor tanpa parameter, atau melalui EntityConnection(String) konstruktor, yang menerima string koneksi. Dalam kedua kasus, string koneksi dapat diubah beberapa kali sebelum koneksi dibuka. Memanggil Open atau GetMetadataWorkspace mengunci metadata.

• Instans EntityConnection dibangun melalui EntityConnection(MetadataWorkspace, DbConnection) konstruktor, yang menerima MetadataWorkspace dan DbConnection. Dalam hal ini metadata dikunci pada waktu konstruksi. Tidak ada perubahan pada string koneksi yang diizinkan.

Ketika metadata dimuat, EntityConnection memverifikasi bahwa model konseptual, model penyimpanan, dan file pemetaan semuanya ada.

Untuk contoh kode, lihat Bekerja dengan EntityClient.

EntityConnection()

Menginisialisasi instans baru kelas EntityConnection.

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

Keterangan

Untuk menghindari secara tidak sengaja menempatkan objek seperti System.Data.Common.CommandTrees dan ObjectContext tidak sinkron dengan metadatanya, EntityConnection harus mengunci metadatanya. Tidak ada perubahan pada string koneksi yang diizinkan setelah metadata dikunci. Berikut ini adalah dua skenario di mana metadata dikunci:

• Instans EntityConnection dibangun melalui konstruktor tanpa parameter, atau melalui EntityConnection(String) konstruktor, yang menerima string koneksi. Dalam kedua kasus, string koneksi dapat diubah beberapa kali sebelum koneksi dibuka. Memanggil Open atau GetMetadataWorkspace mengunci metadata.

• Instans EntityConnection dibangun melalui EntityConnection(MetadataWorkspace, DbConnection) konstruktor, yang menerima MetadataWorkspace dan DbConnection. Dalam hal ini metadata dikunci pada waktu konstruksi. Tidak ada perubahan pada string koneksi yang diizinkan.

Ketika metadata dimuat, EntityConnection memverifikasi bahwa model konseptual, model penyimpanan, dan file pemetaan semuanya ada.

Untuk contoh kode, lihat Bekerja dengan EntityClient.

EntityConnection(String)

Menginisialisasi instans EntityConnection baru kelas, berdasarkan string koneksi.

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)

Parameter

connectionString

String

String koneksi khusus penyedia.

Pengecualian

ArgumentException

Kata kunci string koneksi tidak valid telah disediakan, atau kata kunci string koneksi yang diperlukan belum disediakan.

Keterangan

Alat Model Data Entitas menghasilkan string koneksi bernama yang disimpan dalam file konfigurasi aplikasi. String koneksi bernama ini dapat disediakan sebagai pengganti connectionString parameter saat Anda membuat EntityConnection instans kelas.

Untuk menghindari secara tidak sengaja menempatkan objek System.Data.Common.CommandTrees dan ObjectContext tidak sinkron dengan metadatanya, EntityConnection harus mengunci metadatanya. Tidak ada perubahan pada string koneksi yang diizinkan setelah metadata dikunci. Berikut ini adalah dua skenario di mana metadata dikunci:

• Instans EntityConnection dibangun melalui konstruktor tanpa parameter, atau melalui konstruktor ini (EntityConnection(String)), yang menerima string koneksi. Dalam kedua kasus, string koneksi dapat diubah beberapa kali sebelum koneksi dibuka. Memanggil Open atau GetMetadataWorkspace mengunci metadata.

• Instans EntityConnection dibangun melalui EntityConnection(MetadataWorkspace, DbConnection) konstruktor, yang menerima MetadataWorkspace dan DbConnection. Dalam hal ini metadata dikunci pada waktu konstruksi. Tidak ada perubahan pada string koneksi yang diizinkan.

Ketika metadata dimuat, EntityConnection memverifikasi bahwa model konseptual, model penyimpanan, dan file pemetaan semuanya ada.

Untuk contoh kode, lihat Bekerja dengan EntityClient.

EntityConnection(MetadataWorkspace, DbConnection)

Menginisialisasi instans EntityConnection baru kelas dengan dan DbConnectionyang ditentukanMetadataWorkspace.

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)

Parameter

workspace

MetadataWorkspace

yang MetadataWorkspace akan dikaitkan dengan ini EntityConnection.

connection

DbConnection

Koneksi sumber data yang mendasar untuk objek ini EntityConnection .

Pengecualian

ArgumentNullException

Parameter workspace atau connection adalah null.

ArgumentException

Model konseptual hilang dari ruang kerja.

-atau-

File pemetaan hilang dari ruang kerja.

-atau-

Model penyimpanan hilang dari ruang kerja.

-atau-

connection tidak dalam keadaan tertutup.

ProviderIncompatibleException

connection bukan dari penyedia yang kompatibel dengan Kerangka Kerja Entitas ADO.NET.

Keterangan

Konstruktor ini memungkinkan Anda membuat EntityConnection metadata dari yang bukan dari file pada disk atau dari sumber daya yang disematkan dalam perakitan.

Untuk menghindari menempatkan objek secara tidak sengaja seperti System.Data.Common.CommandTrees dan ObjectContext tidak sinkron dengan metadatanya, EntityConnection harus mengunci metadatanya. Tidak ada perubahan pada string koneksi yang diizinkan setelah metadata dikunci. Berikut ini adalah dua skenario di mana metadata dikunci:

• Instans EntityConnection dibangun melalui konstruktor tanpa parameter, atau melalui EntityConnection(String) konstruktor, yang menerima string koneksi. Dalam kedua kasus, string koneksi dapat diubah beberapa kali sebelum koneksi dibuka. Memanggil Open atau GetMetadataWorkspace mengunci metadata.

• Instans EntityConnection dibangun melalui konstruktor ini (EntityConnection(MetadataWorkspace, DbConnection)), yang menerima MetadataWorkspace dan DbConnection. Dalam hal ini metadata dikunci pada waktu konstruksi. Tidak ada perubahan pada string koneksi yang diizinkan.

Ketika metadata dimuat, EntityConnection memverifikasi bahwa model konseptual, model penyimpanan, dan file pemetaan semuanya ada.