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

Artículo
04/13/2012

Se le llama para completar BeginExecute.

Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)

Sintaxis

'Declaración
Public Function EndExecute(Of TElement) ( _
    asyncResult As IAsyncResult _
) As IEnumerable(Of TElement)
'Uso
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 no admite tipos y métodos genéricos.

Parámetros de tipo

TElement
Tipo devuelto por la consulta.

Parámetros

asyncResult
Tipo: System.IAsyncResult
Objeto IAsyncResult.

Valor devuelto

Tipo: System.Collections.Generic.IEnumerable<TElement>
Resultados devueltos por la operación de consulta.

Excepciones

Excepción	Condición
ArgumentNullException	Cuando asyncResult es nulles una referencia NULL (Nothing en Visual Basic)..
ArgumentException	Cuando asyncResult no se originó desde esta instancia de DataServiceContext. O bien Cuando se llamó previamente al método EndExecute.
InvalidOperationException	Cuando se produce un error durante la ejecución de la solicitud o cuando convierte el contenido del mensaje de respuesta en objetos.
DataServiceQueryException	Cuando el servicio de datos devuelve un error HTTP 404: Recurso no encontrado.

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, vea Operaciones asincrónicas (WCF Data Services).

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.

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 basándose en el servicio de datos de Northwind, que se crea cuando se completa el tutorial rápido de Servicios de datos de Microsoft 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);
        }
    }
}