DataServiceContext.BeginExecute Método

Definición

Espacio de nombres:

System.Data.Services.Client

Ensamblado:

System.Data.Services.Client.dll

Envía de forma asincrónica una solicitud al servicio de datos para ejecutar un URI concreto.

Sobrecargas

BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Envía de forma asincrónica una solicitud al servicio de datos para recuperar la página siguiente de datos en un resultado de consulta paginado.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Envía de forma asincrónica la solicitud para que esta llamada no bloquee el procesamiento mientras se esperan los resultados del servicio.

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

Envía de forma asincrónica una solicitud al servicio de datos para recuperar la página siguiente de datos en un resultado de consulta paginado.

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

Parámetros de tipo

T

Tipo devuelto por la consulta.

Parámetros

continuation

DataServiceQueryContinuation<T>

Objeto DataServiceQueryContinuation<T> que representa la siguiente página de datos para devolver del servicio de datos.

callback

AsyncCallback

Delegado que se va a invocar cuando los resultados estén disponibles para consumo del cliente.

state

Object

Objeto de estados definido por el usuario pasado a la devolución de llamada.

Devoluciones

IAsyncResult

IAsyncResult que representa el estado de la operación.

Comentarios

El objeto DataServiceQueryContinuation<T> proporcionado contiene el URI que, cuando se ejecuta, devuelve la página siguiente de datos del resultado de la consulta.

BeginExecute<TElement>(Uri, AsyncCallback, Object)

Envía de forma asincrónica la solicitud para que esta llamada no bloquee el procesamiento mientras se esperan los resultados del servicio.

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

Parámetros de tipo

TElement

Tipo devuelto por la consulta.

Parámetros

requestUri

Uri

URI al que se enviará la solicitud de consulta. El URI puede ser cualquier URI de servicio de datos válido; puede contener parámetros de consulta $.

callback

AsyncCallback

Delegado que se va a invocar cuando los resultados estén disponibles para consumo del cliente.

state

Object

Objeto de estados definido por el usuario pasado a la devolución de llamada.

Devoluciones

IAsyncResult

Objeto que se usa para realizar un seguimiento del estado de la operación asincrónica.

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

El objeto IAsyncResult devuelto se usa para determinar cuándo se ha completado la operación asincrónica. Para obtener más información, consulte Operaciones asincrónicas.

El método BeginExecute usa la misma semántica que Execute; sin embargo, este método envía la solicitud de forma asincrónica para que esta llamada no bloquee el procesamiento mientras se esperan los resultados del servicio. 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.

Consulte también

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