EntityCollection<TEntity>.Load(MergeOption) Método

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)

Parâmetros

Exemplos

Este exemplo é baseado no Modelo de Vendas da Adventure Works. Para executar o código neste exemplo, você já deve ter adicionado o Modelo de Vendas AdventureWorks ao seu projeto e configurado seu projeto para usar o Entity Framework. Para fazer isso, conclua os procedimentos em Como configurar manualmente um projeto do Entity Framework e Como definir manualmente os arquivos de modelo e mapeamento.

Este exemplo carrega os objetos SalesOrderHeader relacionados para a entidade 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()));
        }
    }
}

Comentários

Esse método chama o método RelatedEnd.ValidateLoad interno antes de carregar a coleção, o que valida que uma chamada para Load tem as condições corretas. O método RelatedEnd.ValidateLoad verifica se:

• Existe uma ObjectContext válida.
• A entidade não está em um estado Deleted.
• MergeOption para Load deve ser NoTracking se e somente se a entidade de origem foi NoTracking. Se a entidade de origem foi recuperada com qualquer outro MergeOption, o LoadMergeOption pode ser tudo menos NoTracking (por exemplo, a entidade pode ter sido carregada com OverwriteChanges e a opção Load pode ser AppendOnly).
• Se mergeOption for NoTracking, Load não será chamado em uma entidade já carregada e Load não será chamado em um RelatedEndnão vazio e não rastreado.

Quando os objetos na coleção já são carregados no ObjectContext, o método Load impõe a MergeOption especificada pelo parâmetro mergeOption. Para obter mais informações, consulte Resolução de Identidade, Gerenciamento de Estado e Controle de Alterações.

Para carregar explicitamente objetos relacionados, você deve chamar o método Load no final relacionado retornado pela propriedade de navegação. Para uma relação um-para-muitos, chame o método Load em EntityCollection<TEntity>. Para uma relação um-para-um, chame o Load em EntityReference<TEntity>. Isso carrega os dados de objeto relacionados no contexto do objeto. Você pode enumerar por meio da coleção de resultados retornados usando um loop foreach (For Each...Next no Visual Basic) e chamar condicionalmente o método Load em propriedades EntityReference<TEntity> e EntityCollection<TEntity> para cada entidade nos resultados.

O método Load carrega objetos relacionados da fonte de dados se IsLoaded está ou não true.

O método EntityCollection<TEntity>.Load é sincronizado com o método EntityReference<TEntity>.Load.

Aplica-se a