DataServiceContext.LoadProperty-Methode (Object, String)
Lädt verzögerte Inhalte für eine angegebene Eigenschaft vom Datendienst.
Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Function LoadProperty ( _
entity As Object, _
propertyName As String _
) As QueryOperationResponse
'Usage
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
Parameter
- entity
Typ: System.Object
Die Entität, die die zu ladende Eigenschaft enthält.
- propertyName
Typ: System.String
Der Name der Eigenschaft in der zu ladenden Entität.
Rückgabewert
Typ: System.Data.Services.Client.QueryOperationResponse
Die Antwort auf den Ladevorgang.
Hinweise
Durch Aufrufen dieser Methode wird ein Netzwerkvorgang zum Abrufe des Eigenschaftswerts aktiviert. Die angegebene Eigenschaft ist möglicherweise eine der Eigenschaften einer Entität, einschließlich Eigenschaften, die Zuordnungen oder Links darstellen.
Wenn die Eigenschaft eine Zuordnung oder einen Link oder eine verzögerte Eigenschaft darstellt, erhät der Client durch den Aufruf dieser Methode eine Möglichkeit, verwandte Ressourcen langsamer zu laden.
Wenn die Entität im unveränderten oder geänderten Zustand ist, lädt der Eigenschaftswert die verknüpften Entitäten und markiert sie unverändert mit unveränderten Links
Wenn die Eigenschaft bereits geladen wird, können Sie durch Aufrufen dieser Methode den Wert der Eigenschaft aktualisieren.
Beispiele
Im folgenden Beispiel wird gezeigt, wie das Customers-Objekt, das sich auf jede zurückgegebene Orders-Instanz bezieht, explizit geladen wird. In diesem Beispiel wird der vom Tool erzeugte DataServiceContext auf Grundlage des Northwind-Datendiensts hinzugefügt. Dieser wird erstellt, wenn Sie den WCF Data ServicesSchnellstart durchführen.
' 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);
}