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 özelliğinden Value erişilir.

İlgili 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 yöntemini EntityReference<TEntity> ve EntityCollection<TEntity> özelliklerini koşullu olarak çağırabilirsinizLoad.

yöntemi, Load veri kaynağından ilgili nesneleri (olsa da olmasa da) trueIsLoaded yükler.

Not

(C#) veya For Each (Visual Basic) numaralandırması sırasında foreach yöntemini çağırdığınızdaLoad, Nesne Hizmetleri yeni bir veri okuyucu açmaya çalışır. Bağlantı dizesinde 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 işlem veri okuyucuyu kapatır ve başvurulan nesneleri yüklemek için koleksiyon üzerinde numaralandırmanıza olanak tanır.

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 bir var ObjectContext .
• 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 MergeOptionLoadMergeOption herhangi bir ile alındıysa , dışında NoTracking herhangi bir şey olabilir (örneğin, varlık yüklenmiş OverwriteChanges olabilir ve Load seçeneği olabilir).AppendOnly
• isemergeOption, zaten yüklenmiş bir varlıkta çağrılmaz ve Load boş olmayan, izlenmeyen bir varlıkta çağrılmazRelatedEnd. LoadNoTracking

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

Ayrıca bkz.

• Verileri Nesne Olarak Sorgulama (Entity Framework)