DataServiceContext.BeginExecute Metoda

Definice

Obor názvů:

System.Data.Services.Client

Sestavení:

System.Data.Services.Client.dll

Asynchronně odešle požadavek datové službě na spuštění konkrétního identifikátoru URI.

Přetížení

BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Asynchronně odešle požadavek datové službě na načtení další stránky dat ve výsledku stránkovaného dotazu.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Asynchronně odešle požadavek tak, aby toto volání neblokovala zpracování při čekání na výsledky ze služby.

BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

Asynchronně odešle požadavek datové službě na načtení další stránky dat ve výsledku stránkovaného dotazu.

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

Parametry typu

T

Typ vrácený dotazem.

Parametry

continuation

DataServiceQueryContinuation<T>

Objekt DataServiceQueryContinuation<T> , který představuje další stránku dat, která se má vrátit z datové služby.

callback

AsyncCallback

Delegování vyvolá, když jsou k dispozici výsledky pro využití klienta.

state

Object

Objekt stavu definovaný uživatelem předaný zpětnému volání.

Návraty

IAsyncResult

Představuje IAsyncResult stav operace.

Poznámky

Zadaný DataServiceQueryContinuation<T> objekt obsahuje identifikátor URI, který při spuštění vrátí další stránku dat ve výsledku dotazu.

BeginExecute<TElement>(Uri, AsyncCallback, Object)

Asynchronně odešle požadavek tak, aby toto volání neblokovala zpracování při čekání na výsledky ze služby.

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

Parametry typu

TElement

Typ vrácený dotazem.

Parametry

requestUri

Uri

Identifikátor URI, na který se odešle požadavek dotazu. Identifikátor URI může být libovolný platný identifikátor URI datové služby. může obsahovat $ parametry dotazu.

callback

AsyncCallback

Delegování vyvolá, když jsou k dispozici výsledky pro využití klienta.

state

Object

Objekt stavu definovaný uživatelem předaný zpětnému volání.

Návraty

IAsyncResult

Objekt, který se používá ke sledování stavu asynchronní operace.

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

IAsyncResult Vrácený objekt se používá k určení, kdy byla asynchronní operace dokončena. Další informace najdete v tématu Asynchronní operace.

Metoda BeginExecute používá stejnou sémantiku jako Execute, ale tato metoda asynchronně odesílá požadavek, aby toto volání neblokovala zpracování při čekání na výsledky ze služby. Podle standardního asynchronního vzoru začátek-konec se zadané zpětné volání vyvolá při načtení výsledků dotazu.

Viz také

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