DataServiceContext.BeginExecute Metodo

Definizione

Spazio dei nomi:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Invia in modo asincrono una richiesta al servizio dati per eseguire un URI specifico.

Overload

BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Invia in modo asincrono una richiesta al servizio dati per recuperare la pagina di dati successiva in un risultato di query di cui è stato eseguito il paging.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Invia in modo asincrono la richiesta in modo che questa chiamata non blocchi l'elaborazione mentre è in attesa dei risultati dal servizio.

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

Invia in modo asincrono una richiesta al servizio dati per recuperare la pagina di dati successiva in un risultato di query di cui è stato eseguito il paging.

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

Parametri di tipo

T

Tipo restituito dalla query.

Parametri

continuation

DataServiceQueryContinuation<T>

Oggetto DataServiceQueryContinuation<T> che rappresenta la pagina di dati successiva da restituire dal servizio dati.

callback

AsyncCallback

Delegato da richiamare se sono disponibili risultati per l'utilizzo client.

state

Object

Oggetto stato definito dall'utente passato al callback.

Restituisce

IAsyncResult

Oggetto IAsyncResult che rappresenta lo stato dell'operazione.

Commenti

L'oggetto DataServiceQueryContinuation<T> fornito contiene l'URI che, in caso di esecuzione, restituisce la pagina di dati successiva nel risultato della query.

BeginExecute<TElement>(Uri, AsyncCallback, Object)

Invia in modo asincrono la richiesta in modo che questa chiamata non blocchi l'elaborazione mentre è in attesa dei risultati dal servizio.

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

Parametri di tipo

TElement

Tipo restituito dalla query.

Parametri

requestUri

Uri

URI al quale verrà inviata la richiesta della query. Può essere qualsiasi URI del servizio dati valido e può contenere parametri di query $.

callback

AsyncCallback

Delegato da richiamare se sono disponibili risultati per l'utilizzo client.

state

Object

Oggetto stato definito dall'utente passato al callback.

Restituisce

IAsyncResult

Oggetto utilizzato per rilevare lo stato dell'operazione asincrona.

Esempio

Nell'esempio seguente viene illustrato come eseguire una query asincrona chiamando il metodo BeginExecute per l'avvio della query. Il delegato inline chiama il metodo EndExecute per visualizzare i risultati della query. In questo esempio viene usato lo DataServiceContext strumento Aggiungi riferimento al servizio basato sul servizio dati Northwind, creato al termine dell'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

L'oggetto IAsyncResult restituito viene utilizzato per determinare se è stata completata l'operazione asincrona. Per altre informazioni, vedere Operazioni asincrone.

Il metodo BeginExecute utilizza la stessa semantica di Execute. Questo metodo invia tuttavia in modo asincrono la richiesta in modo che la chiamata non blocchi elaborazione mentre è in attesa dei risultati dal servizio. In base al modello asincrono Begin-End standard, il callback fornito viene richiamato in fase di recupero dei risultati della query.

Vedi anche

• Procedura: eseguire query asincrone sul servizio dati (WCF Data Services)