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

Ejemplos

Este ejemplo se basa en el modelo de ventas de Adventure Works. Para ejecutar el código en este ejemplo, debe haber agregado el modelo de ventas de AdventureWorks al proyecto y configurado el proyecto para usar Entity Framework. Para ello, complete los procedimientos de Cómo: Configurar manualmente una Project y Cómo: Definir manualmente los archivos de modelo y asignación.

En este ejemplo se cargan los objetos relacionados SalesOrderHeader para la Contact entidad.

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

Comentarios

Este método llama al método interno RelatedEnd.ValidateLoad antes de cargar la colección, que valida que una llamada a Load tiene las condiciones correctas. El RelatedEnd.ValidateLoad método comprueba que:

• Existe un valor válido ObjectContext .
• La entidad no está en un Deleted estado.
• MergeOption para Load debe ser NoTracking si y solo si la entidad de origen era NoTracking. Si la entidad de origen se recuperó con cualquier otra , MergeOptionLoad puede ser cualquier cosaMergeOption, pero NoTracking (por ejemplo, la entidad podría haberse cargado con OverwriteChanges y la Load opción puede ser AppendOnly).
• Si mergeOption es NoTracking, Load no se llama a en una entidad ya cargada y Load no se llama a en un no vacío, sin seguimiento RelatedEnd.

Cuando los objetos de la colección ya se cargan en ObjectContext, el Load método aplica el MergeOption especificado por el mergeOption parámetro . Para obtener más información, consulte Resolución de identidades, Administración de estado y Seguimiento de cambios.

Para cargar explícitamente objetos relacionados, debe llamar al Load método en el extremo relacionado devuelto por la propiedad de navegación. Para una relación uno a varios, llame al Load método en EntityCollection<TEntity>. Para una relación uno a uno, llame a Load en EntityReference<TEntity>. Esto carga los datos del objeto relacionados en el contexto del objeto. Puede enumerar a través de la colección de resultados devueltos mediante un bucle /> / en Visual Basic) y llamar condicionalmente al método en y para cada entidad de los resultados.

El Load método carga objetos relacionados desde el origen de datos si es IsLoadedo no true .

El EntityCollection<TEntity>.Load método se sincroniza con el EntityReference<TEntity>.Load método .