DataServiceContext.EndExecute<TElement>(IAsyncResult) Metodo

public:
generic <typename TElement>
 System::Collections::Generic::IEnumerable<TElement> ^ EndExecute(IAsyncResult ^ asyncResult);

public System.Collections.Generic.IEnumerable<TElement> EndExecute<TElement>(IAsyncResult asyncResult);

member this.EndExecute : IAsyncResult -> seq<'Element>

Public Function EndExecute(Of TElement) (asyncResult As IAsyncResult) As IEnumerable(Of TElement)

Parametri di tipo

Parametri

Valori restituiti

Risultati restituiti dall'operazione di query.

Eccezioni

Esempio

Nell'esempio seguente viene illustrato come eseguire una query asincrona chiamando il BeginExecute metodo per avviare la query. Il delegato inline chiama il EndExecute metodo per visualizzare i risultati della query. Questo esempio usa l'oggetto DataServiceContext generato dallo strumento Add Service Reference basato sul servizio dati Northwind, creato al termine di WCF Data Services.

public static void BeginExecuteCustomersQuery()
{
    // Create the DataServiceContext using the service URI.
    NorthwindEntities context = new NorthwindEntities(svcUri);

    // Define the query to execute asynchronously that returns
    // all customers with their respective orders.
    DataServiceQuery<Customer> query = (DataServiceQuery<Customer>)(from cust in context.Customers.Expand("Orders")
                                       where cust.CustomerID == "ALFKI"
                                       select cust);

    try
    {
        // Begin query execution, supplying a method to handle the response
        // and the original query object to maintain state in the callback.
        query.BeginExecute(OnCustomersQueryComplete, query);
    }
    catch (DataServiceQueryException ex)
    {
        throw new ApplicationException(
            "An error occurred during query execution.", ex);
    }
}

// Handle the query callback.
private static void OnCustomersQueryComplete(IAsyncResult result)
{
    // Get the original query from the result.
    DataServiceQuery<Customer> query =
        result as DataServiceQuery<Customer>;

    foreach (Customer customer in query.EndExecute(result))
    {
        Console.WriteLine("Customer Name: {0}", customer.CompanyName);
        foreach (Order order in customer.Orders)
        {
            Console.WriteLine("Order #: {0} - Freight $: {1}",
                order.OrderID, order.Freight);
        }
    }
}

Public Shared Sub BeginExecuteCustomersQuery()
    ' Create the DataServiceContext using the service URI.
    Dim context = New NorthwindEntities(svcUri)

    ' Define the delegate to callback into the process
    Dim callback As AsyncCallback = AddressOf OnCustomersQueryComplete

    ' Define the query to execute asynchronously that returns 
    ' all customers with their respective orders.
    Dim query As DataServiceQuery(Of Customer) =
    context.Customers.Expand("Orders")

    Try
        ' Begin query execution, supplying a method to handle the response
        ' and the original query object to maintain state in the callback.
        query.BeginExecute(callback, query)
    Catch ex As DataServiceQueryException
        Throw New ApplicationException(
                "An error occurred during query execution.", ex)
    End Try
End Sub
' Handle the query callback.
Private Shared Sub OnCustomersQueryComplete(ByVal result As IAsyncResult)
    ' Get the original query from the result.
    Dim query As DataServiceQuery(Of Customer) =
        CType(result.AsyncState, DataServiceQuery(Of Customer))

    ' Complete the query execution.
    For Each customer As Customer In query.EndExecute(result)
        Console.WriteLine("Customer Name: {0}", customer.CompanyName)
        For Each order As Order In customer.Orders
            Console.WriteLine("Order #: {0} - Freight $: {1}",
                    order.OrderID, order.Freight)
        Next
    Next
End Sub

Commenti

In base al modello asincrono di inizio standard, il callback fornito viene richiamato quando vengono recuperati i risultati della query. Per altre informazioni, vedere Operazioni asincrone.

Quando viene richiamato il callback, tutti i risultati sono stati letti dal flusso HTTP, ma non sono stati elaborati; non sono stati materializzati o modificati oggetti locali per l'utente e la risoluzione delle identità non si è verificata. Quando EndExecute viene richiamato, viene creato e restituito un DataServiceResponse oggetto , ma i risultati non sono ancora stati elaborati. La risoluzione dell'identità, la materializzazione degli oggetti e la manipolazione si verificano solo quando l'utente enumera i risultati.

Vedi anche

• Procedura: Eseguire query asincrone del servizio dati (WCF Data Services)