EntityReference<TEntity>.Load(MergeOption) Yöntem

Tanım

Ad Alanı:

System.Data.Objects.DataClasses

Bütünleştirilmiş Kod:

System.Data.Entity.dll

Belirtilen birleştirme seçeneğiyle bunun EntityReference<TEntity> için ilgili nesneyi yükler.

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 -> unit

Public Overrides Sub Load (mergeOption As MergeOption)

Parametreler

mergeOption

MergeOption

içinde zaten varsa ObjectContextnesnenin nasıl döndürülmesi gerektiğini belirtir.

Özel durumlar

InvalidOperationException

öğesinin EntityReference<TEntity> kaynağıdır null.

-veya-

Sorgu birden fazla ilgili uç döndürdü.

-veya-

Sorgu, ilişkili sıfır uç döndürdü ve ilgili bir uç bekleniyordu.

Açıklamalar

Bu yöntem ilgili nesneyi yüklemek için kullanılır.

Yüklendiğinde, ilgili nesneye Value özelliğinden erişilir.

İlişkili nesneleri açıkça yüklemek için, gezinti özelliği tarafından döndürülen ilgili uçta yöntemini çağırmanız Load gerekir. Bire çok ilişkisi için yöntemini üzerinde çağırın Load ve bire bir ilişki için üzerinde EntityReference<TEntity>öğesini çağırınLoad.EntityCollection<TEntity> Bu, ilgili nesne verilerini nesne bağlamı içine yükler. Sorgu sonuçları döndürdüğünde, bir foreach döngü (For Each...NextVisual Basic'te) kullanarak nesne koleksiyonunda numaralandırabilir ve sonuçlardaki her varlık için ve EntityCollection<TEntity> özelliklerinde yöntemini EntityReference<TEntity> koşullu olarak çağırabilirsinizLoad.

yöntemi, Load olsun veya olmasın IsLoadedtrueveri kaynağından ilgili nesneleri yükler.

Not

(C#) veya For Each (Visual Basic) numaralandırması sırasında foreach yöntemini çağırdığınızdaLoad, Object Services yeni bir veri okuyucu açmayı dener. bağlantı dizesi belirterek multipleactiveresultsets=true birden çok etkin sonuç kümesini etkinleştirmediğiniz sürece bu işlem başarısız olur. Sorgunun sonucunu bir List<T> koleksiyona da yükleyebilirsiniz. Bu, veri okuyucuyu kapatır ve başvurulan nesneleri yüklemek için koleksiyon üzerinde numaralandırmanızı sağlar.

Bu yöntem, bir çağrısının Load doğru koşullara sahip olduğunu doğrulayan ilgili nesneyi yüklemeden önce iç RelatedEnd.ValidateLoad yöntemi çağırır. yöntemi aşağıdakileri RelatedEnd.ValidateLoad denetler:

• Geçerli ObjectContext bir var.
• Varlık bir Deleted durumda değil.
• MergeOptioniçin Load ise ve yalnızca kaynak varlık ise NoTrackingolmalıdırNoTracking. Kaynak varlık başka MergeOptionherhangi bir ile alındıysa , LoadMergeOption dışında NoTracking herhangi bir şey olabilir (örneğin, varlık ile OverwriteChanges yüklenmiş olabilir ve Load seçeneği olabilir AppendOnly).
• ise, zaten yüklenmiş bir varlıkta çağrılmıyorsa ve Load boş olmayan, izlenmeyen bir varlıkta çağrılmıyorsa mergeOptionRelatedEnd. LoadNoTracking

İlgili nesne içinde ObjectContextLoad zaten yüklendiğinde, yöntemi parametresi tarafından belirtileni MergeOptionmergeOption zorlar. Daha fazla bilgi için bkz. Kimlik Çözümleme, Durum Yönetimi ve Değişiklik İzleme.

Ayrıca bkz.

• Verileri Nesne Olarak Sorgulama (Entity Framework)