EntityCollection<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ğini kullanarak ilgili nesneleri koleksiyona 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

Bu koleksiyondaki nesnelerin aynı ObjectContextsorguya karşı önceki sorgulardan döndürülebilecek nesnelerle nasıl birleştirileceği belirtir.

Örnekler

Bu örnek Adventure Works Satış Modeli'ni temel alır. Bu örnekteki kodu çalıştırmak için AdventureWorks Satış Modeli'ni projenize zaten eklemiş ve projenizi Entity Framework kullanacak şekilde yapılandırmış olmanız gerekir. Bunu yapmak için, H nasıl yapılır: Entity Framework Project ve H nasıl yapılır: Model ve Eşleme Dosyalarını El ile Tanımlama içindeki yordamları tamamlayın.

Bu örnek, varlık için SalesOrderHeader ilgili Contact nesneleri yükler.

// Specify the customer ID.
int contactID = 4332;

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    context.ContextOptions.LazyLoadingEnabled = false;

    // Get a specified customer by contact ID.
    var contact =
        (from c in context.Contacts
         where c.ContactID == contactID
         select c).First();

    // Load the orders for the customer explicitly.
    if (!contact.SalesOrderHeaders.IsLoaded)
    {
        contact.SalesOrderHeaders.Load();
    }

    foreach (SalesOrderHeader order in contact.SalesOrderHeaders)
    {
        // Load the items for the order if not already loaded.
        if (!order.SalesOrderDetails.IsLoaded)
        {
            order.SalesOrderDetails.Load();
        }

        Console.WriteLine(String.Format("PO Number: {0}",
            order.PurchaseOrderNumber));
        Console.WriteLine(String.Format("Order Date: {0}",
            order.OrderDate.ToString()));
        Console.WriteLine("Order items:");
        foreach (SalesOrderDetail item in order.SalesOrderDetails)
        {
            Console.WriteLine(String.Format("Product: {0} "
                + "Quantity: {1}", item.ProductID.ToString(),
                item.OrderQty.ToString()));
        }
    }
}

Açıklamalar

Bu yöntem, bir çağrısının RelatedEnd.ValidateLoad doğru koşullara sahip olduğunu doğrulayan koleksiyonu yüklemeden önce iç Load 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 NoTracking boş olmayan, izlenmeyen bir varlıkta çağrılmazLoad. LoadRelatedEnd

Koleksiyondaki nesneler içine 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.

İ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 üzerinde yöntemini LoadçağırınEntityCollection<TEntity>. Bire bir ilişki için üzerinde Loadöğesini çağırınEntityReference<TEntity>. Bu, ilgili nesne verilerini nesne bağlamı içine yükler. Döndürülen sonuçların koleksiyonunu bir foreach döngüsü (Visual Basic'da For Each...Next) kullanarak listeleyebilir ve sonuçlardaki her varlık için Load ve EntityReference<TEntity> özelliklerinde EntityCollection<TEntity> yöntemini koşullu olarak çağırabilirsiniz.

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

Note

(C#) veya Load (Visual Basic) numaralandırması sırasında foreach yöntemini çağırdığınızdaFor Each, 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.

EntityCollection<TEntity>.Load yöntemi yöntemiyle EntityReference<TEntity>.Load eşitlenir.