Metodo DataServiceContext.LoadProperty (Object, String)
Carica il contenuto posticipato per una proprietà specificata dal servizio dati.
Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Spazio dei nomi System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Sintassi
'Dichiarazione
Public Function LoadProperty ( _
entity As Object, _
propertyName As String _
) As QueryOperationResponse
'Utilizzo
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
Parametri
- entity
Tipo: System.Object
Entità contenente la proprietà da caricare.
- propertyName
Tipo: System.String
Nome della proprietà dell'entità specificata da caricare.
Valore restituito
Tipo: System.Data.Services.Client.QueryOperationResponse
Risposta all'operazione di caricamento.
Osservazioni
La chiamata di questo metodo richiama un'operazione di rete per recuperare il valore della proprietà. La proprietà specificata può essere una qualsiasi proprietà nell'entità, incluse le proprietà che rappresentano associazioni o collegamenti.
Se la proprietà rappresenta un'associazione o un collegamento oppure una proprietà posticipata, la chiamata di questo metodo fornisce al client un metodo per caricare in ritardo le risorse correlate.
Se l'entità è nello stato non modificato o modificato, il valore della proprietà carica le entità correlate contrassegnandole come non modificate con collegamenti non modificati.
Se la proprietà è già caricata, la chiamata di questo metodo consente di aggiornare il valore della proprietà.
Esempi
Nell'esempio seguente viene illustrato come caricare in modo esplicito l'oggetto Customers correlato a ogni istanza di Orders restituita. In questo esempio viene utilizzato l'oggetto DataServiceContext generato dallo strumento Aggiungi riferimento al servizio in base al servizio dati Northwind, creato al completamento della Guida rapida di WCF Data Services.
' 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);
}