DataServiceContext.BeginExecute Methode

public:
generic <typename T>
 IAsyncResult ^ BeginExecute(System::Data::Services::Client::DataServiceQueryContinuation<T> ^ continuation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginExecute<T>(System.Data.Services.Client.DataServiceQueryContinuation<T> continuation, AsyncCallback callback, object state);

member this.BeginExecute : System.Data.Services.Client.DataServiceQueryContinuation<'T> * AsyncCallback * obj -> IAsyncResult

Public Function BeginExecute(Of T) (continuation As DataServiceQueryContinuation(Of T), callback As AsyncCallback, state As Object) As IAsyncResult

Typparameter

Parameter

Gibt zurück

Ein IAsyncResult Wert, der den Status des Vorgangs darstellt.

Hinweise

Das angegebene DataServiceQueryContinuation<T> Objekt enthält den URI, der beim Ausführen die nächste Datenseite im Abfrageergebnis zurückgibt.

public:
generic <typename TElement>
 IAsyncResult ^ BeginExecute(Uri ^ requestUri, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginExecute<TElement>(Uri requestUri, AsyncCallback callback, object state);

member this.BeginExecute : Uri * AsyncCallback * obj -> IAsyncResult

Public Function BeginExecute(Of TElement) (requestUri As Uri, callback As AsyncCallback, state As Object) As IAsyncResult

Typparameter

Parameter

Gibt zurück

Ein Objekt, das zum Nachverfolgen des Status des asynchronen Vorgangs verwendet wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine asynchrone Abfrage ausführen, indem Sie die BeginExecute Methode aufrufen, um die Abfrage zu starten. Der Inlinedelegat ruft die EndExecute Methode auf, um die Abfrageergebnisse anzuzeigen. In diesem Beispiel wird das DataServiceContext vom Tool "Dienstreferenz hinzufügen" basierend auf dem Northwind-Datendienst generierte Tool verwendet, das beim Abschließen der WCF Data Services erstellt wird.

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

Hinweise

Das zurückgegebene Objekt wird verwendet, um zu bestimmen, wann der asynchrone IAsyncResult Vorgang abgeschlossen ist. Weitere Informationen finden Sie unter "Asynchrone Vorgänge".

Die Methode BeginExecute verwendet dieselbe Semantik wie Executediese Methode sendet die Anforderung asynchron, sodass dieser Aufruf die Verarbeitung nicht blockiert, während auf die Ergebnisse des Diensts gewartet wird. Gemäß dem standardmäßigen asynchronen Start-End-Muster wird der bereitgestellte Rückruf aufgerufen, wenn Abfrageergebnisse abgerufen werden.

Weitere Informationen

• Vorgehensweise: Ausführen asynchroner Datendienstabfragen (WCF Data Services)