Carga el objeto relacionado para este objeto EntityReference<TEntity> con la opción de combinación especificada.
Ensamblado: System.Data.Entity (en System.Data.Entity.dll)
Public Overrides Sub Load ( _ mergeOption As MergeOption _ )
public override void Load( MergeOption mergeOption )
public: virtual void Load( MergeOption mergeOption ) override
abstract Load : mergeOption:MergeOption -> unit override Load : mergeOption:MergeOption -> unit
Parámetros
- mergeOption
- Tipo: System.Data.Objects.MergeOption
Especifica cómo se debe devolver el objeto si ya existe en ObjectContext.
Implementaciones
IRelatedEnd.Load(MergeOption)| Excepción | Condición |
|---|---|
| InvalidOperationException |
El origen de EntityReference<TEntity> es null. O bien Una consulta ha devuelto más de un extremo relacionado. O bien Una consulta ha devuelto cero extremos relacionados, pero se esperaba uno. |
Este método se usa para cargar el objeto relacionado.
Cuando se carga el objeto relacionado, se tiene acceso a él desde la propiedad Value.
Para cargar explícitamente los objetos relacionados, se debe llamar al método Load en el extremo relacionado devuelto por la propiedad de navegación. En una relación de uno a varios, llame al método Load en EntityCollection<TEntity>, y para una relación uno a uno, llame al método Load en EntityReference<TEntity>. De este modo, se cargan los datos de los objetos relacionados en el contexto del objeto. Cuando una consulta devuelve los resultados, se puede enumerar la colección de objetos utilizando un bucle foreach (For Each...Next en Visual Basic) y llamar condicionalmente al método Load en las propiedades EntityReference<TEntity> y EntityCollection<TEntity> para cada entidad en los resultados.
El método Load carga los objetos relacionados del origen de datos tanto si IsLoaded es true como si no lo es.
Nota
|
|---|
|
Cuando se llama al método Load durante una enumeración foreach (C#) o For Each (Visual Basic), Servicios de objeto intenta abrir un nuevo lector de datos. Se producirá un error en esta operación a menos que se hayan habilitado varios conjuntos de resultados activos especificando multipleactiveresultsets=true en la cadena de conexión. También puede cargar el resultado de la consulta en una colección List<T>. Esto cierra el lector de datos y permite llevar a cabo la enumeración en la colección para cargar los objetos a los que se hace referencia. |
Este método llama al método ValidateLoad``1(MergeOption, String) antes de cargar el objeto relacionado. Vea este método para obtener una lista de excepciones adicionales.
Si el objeto relacionado ya está cargado en el ObjectContext, el método Load aplica la MergeOption especificada por el parámetro mergeOption. Para obtener más información, vea Managing the Object Context (Entity Framework).
.NET Framework
Compatible con: 4, 3.5 SP1.NET Framework Client Profile
Compatible con: 4Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Nota