DataServiceContext.BeginExecute Méthode

Définition

Espace de noms:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Envoie de façon asynchrone une requête au service de données pour exécuter l'URI spécifique.

Surcharges

BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Envoie de façon asynchrone une requête au service de données pour récupérer la page de données suivante dans un résultat de requête paginé.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Envoie de façon asynchrone la requête afin que cet appel ne bloque pas le traitement en attendant les résultats du service.

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

Envoie de façon asynchrone une requête au service de données pour récupérer la page de données suivante dans un résultat de requête paginé.

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

Paramètres de type

T

Type retourné par la requête.

Paramètres

continuation

DataServiceQueryContinuation<T>

Objet DataServiceQueryContinuation<T> qui représente la page de données suivante à retourner à partir du service de données.

callback

AsyncCallback

Délégué à appeler lorsque les résultats sont disponibles pour un client.

state

Object

Objet d'état défini par l'utilisateur passé au rappel.

Retours

IAsyncResult

IAsyncResult qui représente l'état de l'opération.

Remarques

L'objet DataServiceQueryContinuation<T> fourni contient l'URI qui, lorsqu'il est exécuté, retourne la page de données suivante dans le résultat de la requête.

BeginExecute<TElement>(Uri, AsyncCallback, Object)

Envoie de façon asynchrone la requête afin que cet appel ne bloque pas le traitement en attendant les résultats du service.

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

Paramètres de type

TElement

Type retourné par la requête.

Paramètres

requestUri

Uri

URI vers lequel la requête d'interrogation sera envoyée. L'URI peut être n'importe quel URI de service de données valide ; il peut contenir des paramètres de requête $.

callback

AsyncCallback

Délégué à appeler lorsque les résultats sont disponibles pour un client.

state

Object

Objet d'état défini par l'utilisateur passé au rappel.

Retours

IAsyncResult

Objet utilisé pour suivre l'état de l'opération asynchrone.

Exemples

L'exemple suivant montre comment exécuter une requête asynchrone en appelant la méthode BeginExecute pour démarrer la requête. Le délégué inline delegate appelle la méthode EndExecute pour afficher les résultats de la requête. Cet exemple utilise le DataServiceContext généré par l’outil Ajouter une référence de service basé sur le service de données Northwind, qui est créé lorsque vous terminez la 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

Remarques

L'objet IAsyncResult retourné est utilisé pour déterminer si l'opération asynchrone est terminée. Pour plus d’informations, consultez opérations asynchrones.

La méthode BeginExecute utilise la même sémantique que la méthode Execute, mais envoie de façon asynchrone la requête de sorte que cet appel ne bloque pas le traitement en attendant les résultats du service. En fonction du modèle asynchrone Begin/End standard, le rappel fourni est appelé lorsque les résultats de la requête sont récupérés.

Voir aussi

• Comment : exécuter les requêtes de services de données asynchrones (services de données WCF)