Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DataServiceContext.LoadProperty (Object, String)

 

Data di pubblicazione: ottobre 2016

Carica il contenuto posticipato per una proprietà specificata dal servizio dati.

Spazio dei nomi:   System.Data.Services.Client
Assembly:  System.Data.Services.Client (in System.Data.Services.Client.dll)

public QueryOperationResponse LoadProperty(
	object entity,
	string propertyName
)

Parametri

entity
Type: System.Object

Entità contenente la proprietà da caricare.

propertyName
Type: System.String

Nome della proprietà dell'entità specificata da caricare.

Valore restituito

Type: System.Data.Services.Client.QueryOperationResponse

Risposta all'operazione di caricamento.

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à.

Nell'esempio seguente viene illustrato come caricare in modo esplicito l'oggetto Customers correlato a ogni istanza di Orders restituita. Questo esempio viene utilizzato il DataServiceContext generato dallo strumento Aggiungi riferimento al servizio in base al servizio dati Northwind, che viene creato quando si completa la WCF Data Services .

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

.NET Framework
Disponibile da 3.5
Torna all'inizio
Mostra: