DataServiceContext.EndExecute<TElement>(IAsyncResult) Metoda

Definice

Obor názvů:

System.Data.Services.Client

Sestavení:

System.Data.Services.Client.dll

Volá se k dokončení BeginExecute<TElement>(Uri, AsyncCallback, Object)příkazu .

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)

Parametry typu

TElement

Typ vrácený dotazem.

Parametry

asyncResult

IAsyncResult

IAsyncResult Objekt.

Návraty

IEnumerable<TElement>

Výsledky vrácené operací dotazu

Výjimky

ArgumentNullException

Když asyncResult je null.

ArgumentException

Kdy asyncResult nepochází z této DataServiceContext instance.

-nebo-

Metoda EndExecute<TElement>(IAsyncResult) byla dříve volána.

InvalidOperationException

Při vyvolání chyby při provádění požadavku nebo při převodu obsahu zprávy odpovědi na objekty.

Příklady

Následující příklad ukazuje, jak spustit asynchronní dotaz voláním BeginExecute metody pro spuštění dotazu. Vložený delegát volá metodu EndExecute pro zobrazení výsledků dotazu. V tomto příkladu DataServiceContext se používá objekt vygenerovaný nástrojem Přidat odkaz na službu založenou na datové službě Northwind, která se vytvoří po dokončení 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

Poznámky

Podle standardního asynchronního vzoru začátek-konec se zadané zpětné volání vyvolá při načtení výsledků dotazu. Další informace najdete v tématu Asynchronní operace.

Při vyvolání zpětného volání byly všechny výsledky načteny z datového proudu HTTP, ale nebyly zpracovány; nebyly materializovány ani změněny žádné místní objekty orientované na uživatele a nedošlo k překladu identity. Při EndExecute vyvolání DataServiceResponse se vytvoří a vrátí, ale výsledky se ještě nezpracovaly. K překladu identity, materializaci objektů a manipulaci dochází pouze v případě, že uživatel vytvoří výčet výsledků.

Viz také

• Postupy: Spouštění dotazů asynchronních datových služeb (WCF Data Services)