Méthode DataServiceContext.EndExecute<TElement> (IAsyncResult)

Article
04/13/2012

Appelé pour terminer la méthode BeginExecute.

Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)

Syntaxe

'Déclaration
Public Function EndExecute(Of TElement) ( _
    asyncResult As IAsyncResult _
) As IEnumerable(Of TElement)
'Utilisation
Dim instance As DataServiceContext
Dim asyncResult As IAsyncResult
Dim returnValue As IEnumerable(Of TElement)

returnValue = instance.EndExecute(asyncResult)

public IEnumerable<TElement> EndExecute<TElement>(
    IAsyncResult asyncResult
)

public:
generic<typename TElement>
IEnumerable<TElement>^ EndExecute(
    IAsyncResult^ asyncResult
)

member EndExecute : 
        asyncResult:IAsyncResult -> IEnumerable<'TElement>

JScript ne prend pas en charge les types et les méthodes génériques.

Paramètres de type

TElement
Type retourné par la requête.

Paramètres

asyncResult
Type : System.IAsyncResult
Objet IAsyncResult.

Valeur de retour

Type : System.Collections.Generic.IEnumerable<TElement>
Résultats obtenus suite à l'opération de requête.

Exceptions

Exception	Condition
ArgumentNullException	Lorsque asyncResult est nullune référence Null (Nothing dans Visual Basic).
ArgumentException	Lorsque asyncResult ne provient pas de cette instance DataServiceContext. ou Lorsque la méthode EndExecute a été appelée précédemment.
InvalidOperationException	Lorsqu'une erreur est levée, soit pendant l'exécution de la requête soit lors de la conversion du contenu du message de réponse en objets.
DataServiceQueryException	Lorsque le service de données retourne une erreur HTTP 404 : Ressource introuvable.

Notes

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. Pour plus d'informations, consultez Opérations asynchrones (WCF Data Services).

Lorsque la fonction de rappel est appelée, tous les résultats sont lus à partir du flux HTTP, mais ils ne sont pas traités ; aucun objet en direction de l'utilisateur local n'est matérialisé ou modifié et la résolution d'identité ne se produit pas. Lorsque EndExecute est appelé, DataServiceResponse est créé et retourné mais les résultats n'ont pas encore été traités. La résolution d'identité, la matérialisation d'objets et la manipulation se produisent uniquement lorsque l'utilisateur énumère les résultats.

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 réalisez le démarrage rapide de Services de données WCF.

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

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);
        }
    }
}