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 uma estrutura de entidade Project e Como definir manualmente os arquivos de modelo e mapeamento.

Este exemplo carrega os objetos relacionados SalesOrderHeader para a Contact entidade.

// 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 interno RelatedEnd.ValidateLoad antes de carregar a coleção, o que valida que uma chamada Load tem as condições corretas. O RelatedEnd.ValidateLoad método verifica se:

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

Quando os objetos na coleção já são carregados no ObjectContextmétodo, o Load método impõe o MergeOption especificado pelo mergeOption parâmetro. 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 Load método na extremidade relacionada retornada pela propriedade de navegação. Para uma relação um-para-muitos, chame o Load método em EntityCollection<TEntity>. Para uma relação um-para-um, chame o Load on 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 em Visual Basic) e chamar condicionalmente o método Load em propriedades EntityReference<TEntity> e EntityCollection<TEntity> para cada entidade nos resultados.

O Load método carrega objetos relacionados da fonte de dados.IsLoadedtrue

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