EntityReference<TEntity>.Load(MergeOption) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memuat objek terkait untuk ini EntityReference<TEntity> dengan opsi penggabungan yang ditentukan.
public:
override void Load(System::Data::Objects::MergeOption mergeOption);public override void Load(System.Data.Objects.MergeOption mergeOption);override this.Load : System.Data.Objects.MergeOption -> unitPublic Overrides Sub Load (mergeOption As MergeOption)Parameter
- mergeOption
- MergeOption
Menentukan bagaimana objek harus dikembalikan jika sudah ada di ObjectContext.
Pengecualian
Sumbernya EntityReference<TEntity> adalah null.
-atau-
Kueri mengembalikan lebih dari satu ujung terkait.
-atau-
Kueri mengembalikan nol akhir terkait, dan satu akhir terkait diharapkan.
Keterangan
Metode ini digunakan untuk memuat objek terkait.
Saat dimuat, objek terkait diakses dari Value properti .
Untuk memuat objek terkait secara eksplisit, Anda harus memanggil Load metode pada akhir terkait yang dikembalikan oleh properti navigasi. Untuk hubungan satu-ke-banyak, panggil Load metode pada EntityCollection<TEntity>, dan untuk hubungan satu-ke-satu, panggil Load di EntityReference<TEntity>. Ini memuat data objek terkait ke dalam konteks objek. Saat kueri mengembalikan hasil, Anda dapat menghitung melalui kumpulan objek menggunakan perulangan foreach (For Each...Next di Visual Basic) dan secara kondisional memanggil Load metode dan EntityReference<TEntity>EntityCollection<TEntity> properti untuk setiap entitas dalam hasil.
Metode memuat Load objek terkait dari sumber data apakah IsLoaded .true
Nota
Saat Anda memanggil Load metode selama foreach enumerasi (C#) atau For Each (Visual Basic), Object Services mencoba membuka pembaca data baru. Operasi ini akan gagal kecuali Anda telah mengaktifkan beberapa kumpulan hasil aktif dengan menentukan multipleactiveresultsets=true dalam string koneksi. Anda juga dapat memuat hasil kueri ke dalam List<T> koleksi. Ini menutup pembaca data dan memungkinkan Anda menghitung koleksi untuk memuat objek yang dirujuk.
Metode ini memanggil metode internal RelatedEnd.ValidateLoad sebelum memuat objek terkait, yang memvalidasi bahwa panggilan untuk Load memiliki kondisi yang benar. Metode RelatedEnd.ValidateLoad memeriksa bahwa:
- Ada yang valid ObjectContext .
- Entitas tidak dalam status Deleted .
- MergeOption untuk Load harus NoTracking jika dan hanya jika entitas sumber adalah NoTracking. Jika entitas sumber diambil dengan yang lain MergeOption,MergeOptionLoadbisa apa saja kecuali NoTracking (misalnya, entitas dapat dimuat dan LoadOverwriteChanges opsinya bisa AppendOnly).
- Jika
mergeOptionadalah NoTracking, Load tidak dipanggil pada entitas yang sudah dimuat dan Load tidak dipanggil pada yang tidak kosong, tidak dilacak RelatedEnd.
Ketika objek terkait sudah dimuat dalam ObjectContext, Load metode memberlakukan MergeOption yang ditentukan oleh mergeOption parameter . Untuk informasi selengkapnya, lihat Resolusi Identitas, Manajemen Status, dan Pelacakan Perubahan.
