DataServiceContext.BeginExecute Метод

Определение

Пространство имен:

System.Data.Services.Client

Сборка:

System.Data.Services.Client.dll

Асинхронно отправляет запрос в службу данных для выполнения указанного URI.

Перегрузки

BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Асинхронно отправляет запрос в службу данных для получения следующей страницы данных в результатах запроса, разбитых на страницы.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Асинхронно отправляет запрос таким образом, чтобы этот вызов не блокировал обработку на время ожидания результатов от службы.

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

Асинхронно отправляет запрос в службу данных для получения следующей страницы данных в результатах запроса, разбитых на страницы.

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

Параметры типа

T

Тип, возвращаемый запросом.

Параметры

continuation

DataServiceQueryContinuation<T>

Объект DataServiceQueryContinuation<T>, представляющий следующую страницу данных для возврата из службы данных.

callback

AsyncCallback

Делегат для вызова, когда результаты доступны для клиента.

state

Object

Определяемый пользователем объект состояния передается функции обратного вызова.

Возвращаемое значение

IAsyncResult

IAsyncResult, представляющий состояние операции.

Комментарии

Предоставленный объект DataServiceQueryContinuation<T> содержит URI, который при выполнении возвращает следующую страницу данных в результатах запроса.

BeginExecute<TElement>(Uri, AsyncCallback, Object)

Асинхронно отправляет запрос таким образом, чтобы этот вызов не блокировал обработку на время ожидания результатов от службы.

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

Параметры типа

TElement

Тип, возвращаемый запросом.

Параметры

requestUri

Uri

URI, на который будет отправлен запрос. URI может быть любым допустимым URI службы данных и содержать параметры запроса $.

callback

AsyncCallback

Делегат для вызова, когда результаты доступны для клиента.

state

Object

Определяемый пользователем объект состояния передается функции обратного вызова.

Возвращаемое значение

IAsyncResult

Объект, используемый для отслеживания состояния асинхронной операции.

Примеры

Следующий пример иллюстрирует выполнение асинхронного запроса путем вызова метода BeginExecute для запуска запроса. Встроенный делегат вызывает метод EndExecute для отображения результатов запроса. В этом примере используется объект , DataServiceContext созданный средством Добавления ссылки на службу на основе службы данных Northwind, который создается при выполнении 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

Комментарии

Возвращаемый объект IAsyncResult используется для определения момента завершения асинхронной операции. Дополнительные сведения см. в разделе Асинхронные операции.

Метод BeginExecute использует ту же семантику, что и метод Execute, однако этот метод асинхронно отправляет запрос таким образом, чтобы вызов не блокировал обработку на время ожидания результатов от службы. В соответствии со стандартной асинхронной технологией begin-end, предоставленный обратный вызов запрашивается при извлечении результатов запроса.

См. также раздел

• Практическое руководство. Выполнение асинхронных запросов к службе данных (службы данных WCF)