EntityCollection<TEntity>.Load(MergeOption) 메서드

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)

매개 변수

예제

이 예제는 Adventure Works Sales 모델을 기반으로 합니다. 이 예제에서 코드를 실행하려면 프로젝트에 AdventureWorks 판매 모델을 이미 추가하고 Entity Framework를 사용하도록 프로젝트를 구성해야 합니다. 이렇게 하려면 방법: Entity Framework Project 및 방법: 모델 및 매핑 파일 수동으로 정의 절차를 완료합니다.

이 예제에서는 엔터티에 대한 관련 SalesOrderHeader 개체를 Contact 로드합니다.

// 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()));
        }
    }
}

설명

이 메서드는 컬렉션을 로드하기 전에 내부 RelatedEnd.ValidateLoad 메서드를 호출하여 호출 Load 에 올바른 조건이 있는지 확인합니다. 메서드는 다음 RelatedEnd.ValidateLoad 을 확인합니다.

• 유효한 ObjectContext 항목이 있습니다.
• 엔터티가 상태가 아닙니다 Deleted .
• MergeOption Load 은 원본 엔터티NoTracking가 NoTracking .인 경우에만 사용해야 합니다. 원본 엔터티를 다른 MergeOptionLoadMergeOption 엔터티와 함께 검색한 경우 엔터티가 로드 NoTracking 되었을 수 OverwriteChanges 있고 Load 옵션이 있을 AppendOnly수 있습니다.
• 이 mergeOptionNoTracking 경우 Load 이미 로드된 엔터티에서 호출되지 않으며 비어 있지 않고 추적Load되지 않은 엔터티 RelatedEnd 에서 호출되지 않습니다.

컬렉션의 개체가 이미 로드된 ObjectContext경우 메서드는 Load 매개 변수로 지정된 개체를 MergeOptionmergeOption 적용합니다. 자세한 내용은 ID 확인, 상태 관리 및 변경 내용 추적을 참조하세요.

관련 개체를 명시적으로 로드하려면 탐색 속성에서 반환된 Load 관련 끝의 메서드를 호출해야 합니다. 일대다 관계의 경우 .에서 메서드를 Load 호출합니다 EntityCollection<TEntity>. 일대일 관계의 경우 을 호출합니다 LoadEntityReference<TEntity>. 그러면 관련 개체 데이터가 개체 컨텍스트로 로드됩니다. foreach 루프(Visual Basic For Each...Next)를 사용하여 반환된 결과 컬렉션을 열거하고 결과의 각 엔터티에 대해 EntityReference<TEntity> 및 EntityCollection<TEntity> > 속성에서 Load 메서드를 조건부로 호출할 수 있습니다.

이 메서드는 Load 데이터 원본 IsLoadedtrue에서 관련 개체를 로드합니다.

EntityCollection<TEntity>.Load 메서드가 메서드와 EntityReference<TEntity>.Load 동기화됩니다.