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

Definición

Espacio de nombres:

System.Data.Services.Client

Ensamblado:

System.Data.Services.Client.dll

Se le llama para completar BeginExecute<TElement>(Uri, AsyncCallback, Object).

public:
generic <typename TElement>
 System::Collections::Generic::IEnumerable<TElement> ^ EndExecute(IAsyncResult ^ asyncResult);

public System.Collections.Generic.IEnumerable<TElement> EndExecute<TElement> (IAsyncResult asyncResult);

member this.EndExecute : IAsyncResult -> seq<'Element>

Public Function EndExecute(Of TElement) (asyncResult As IAsyncResult) As IEnumerable(Of TElement)

Parámetros de tipo

TElement

Tipo devuelto por la consulta.

Parámetros

asyncResult

IAsyncResult

Objeto IAsyncResult.

Devoluciones

IEnumerable<TElement>

Resultados devueltos por la operación de consulta.

Excepciones

ArgumentNullException

Cuando asyncResult es null.

ArgumentException

Cuando asyncResult no se originó desde esta instancia de DataServiceContext.

o bien

El método EndExecute<TElement>(IAsyncResult) se definió previamente.

InvalidOperationException

Cuando se produce un error durante la ejecución de la solicitud o cuando convierte el contenido del mensaje de respuesta en objetos.

Ejemplos

En el siguiente ejemplo se muestra cómo ejecutar una consulta asincrónica llamando al método BeginExecute para iniciar la consulta. El delegado alineado llama al método EndExecute para mostrar los resultados de la consulta. En este ejemplo se usa el DataServiceContext generado por la herramienta Agregar referencia de servicio basada en el servicio de datos Northwind, que se crea al completar el 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

Comentarios

Según el modelo asincrónico estándar de inicio y fin, la devolución de llamada proporcionada se invoca cuando se recuperan los resultados de la consulta. Para obtener más información, consulte Operaciones asincrónicas.

Cuando se invoca la devolución de llamada, todos los resultados se han leído del flujo HTTP, pero no se han procesado; ningún objeto de cara al usuario local se ha materializado o modificado y la resolución de identidades no se ha producido. Cuando se invoca EndExecute, se crea y devuelve DataServiceResponse pero todavía no se han procesado los resultados. La resolución de identidades, la materialización de objetos y la manipulación solo se producen cuando el usuario enumera los resultados.

Consulte también

• Cómo: Ejecutar consultas asincrónicas de Data Services (Data Services de WCF)