DataServiceContext.LoadProperty Método (Object, String)
Carga el contenido aplazado de una propiedad especificada desde el servicio de datos.
No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Sintaxis
'Declaración
Public Function LoadProperty ( _
entity As Object, _
propertyName As String _
) As QueryOperationResponse
'Uso
Dim instance As DataServiceContext
Dim entity As Object
Dim propertyName As String
Dim returnValue As QueryOperationResponse
returnValue = instance.LoadProperty(entity, _
propertyName)
public QueryOperationResponse LoadProperty(
Object entity,
string propertyName
)
public:
QueryOperationResponse^ LoadProperty(
Object^ entity,
String^ propertyName
)
member LoadProperty :
entity:Object *
propertyName:string -> QueryOperationResponse
public function LoadProperty(
entity : Object,
propertyName : String
) : QueryOperationResponse
Parámetros
- entity
Tipo: System.Object
Entidad que contiene la propiedad que se va a cargar.
- propertyName
Tipo: System.String
Nombre de la propiedad de la entidad especificada que se va a cargar.
Valor devuelto
Tipo: System.Data.Services.Client.QueryOperationResponse
Respuesta a la operación de carga.
Comentarios
Al llamar a este método se invoca una operación de red para capturar el valor de propiedad. La propiedad especificada puede ser cualquiera de las propiedades de la entidad, incluidas las propiedades que representan asociaciones o vínculos.
Si la propiedad representa una asociación, un vínculo o una propiedad aplazada, la llamada a este método proporciona al cliente una manera de cargar de forma diferida recursos relacionados.
Si la entidad está en el estado sin modificar o modificado, el valor de la propiedad carga las entidades relacionadas y las marca como sin modificar con vínculos sin modificar.
Si la propiedad ya está cargada, la llamada a este método permite actualizar el valor de la propiedad.
Ejemplos
En el ejemplo siguiente se muestra cómo cargar explícitamente el objeto Customers relacionado con cada instancia de Orders devuelta. En este ejemplo se usa el DataServiceContext generado por la herramienta Agregar referencia de servicio basándose en el servicio de datos de Northwind, que se crea cuando se completa el tutorial rápido de Servicios de datos de Microsoft WCF.
' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)
Try
' Enumerate over the top 10 orders obtained from the context.
For Each order As Order In context.Orders.Take(10)
' Explicitly load the customer for each order.
context.LoadProperty(order, "Customer")
' Write out customer and order information.
Console.WriteLine("Customer: {0} - Order ID: {1}", _
order.Customer.CompanyName, order.OrderID)
Next
Catch ex As DataServiceQueryException
Throw New ApplicationException( _
"An error occurred during query execution.", ex)
End Try
// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);
try
{
// Enumerate over the top 10 orders obtained from the context.
foreach (Order order in context.Orders.Take(10))
{
// Explicitly load the customer for each order.
context.LoadProperty(order, "Customer");
// Write out customer and order information.
Console.WriteLine("Customer: {0} - Order ID: {1}",
order.Customer.CompanyName, order.OrderID);
}
}
catch (DataServiceQueryException ex)
{
throw new ApplicationException(
"An error occurred during query execution.", ex);
}