DataServiceContext.EndExecute<TElement>(IAsyncResult) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird aufgerufen, um BeginExecute<TElement>(Uri, AsyncCallback, Object) abzuschließen.
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)Typparameter
- TElement
Der von der Abfrage zurückgegebene Typ.
Parameter
- asyncResult
- IAsyncResult
IAsyncResult-Objekt
Gibt zurück
Die von der Abfrage zurückgegebenen Ergebnisse.
Ausnahmen
Wenn asyncResultnull ist.
Wenn asyncResult nicht aus dieser DataServiceContext-Instanz stammt.
- oder -
Die EndExecute<TElement>(IAsyncResult)-Methode wurde bereits zuvor aufgerufen.
Wenn ein Fehler entweder während der Ausführung der Anforderung ausgelöst wird oder wenn der Inhalt der Antwortnachricht in Objekte konvertiert wird.
Beispiele
Im folgenden Beispiel wird gezeigt, wie eine asynchrone Abfrage durch Aufrufen der BeginExecute-Methode zum Starten der Abfrage ausgeführt wird. Der Inlinedelegat ruft die EndExecute-Methode zum Anzeigen der Abfrageergebnisse auf. In diesem Beispiel wird das DataServiceContext vom Tool Dienstverweis hinzufügen basierend auf dem Northwind-Datendienst generiert, der erstellt wird, wenn Sie die WCF Data Services abschließen.
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
Hinweise
Entsprechend dem asynchronen Begin/End-Standardmuster wird beim Abrufen der Abfrageergebnisse der bereitgestellte Rückruf aufgerufen. Weitere Informationen finden Sie unter Asynchrone Vorgänge.
Wenn der Rückruf aufgerufen wird, wurden alle Ergebnisse vom HTTP-Datenstrom gelesen, aber sie wurden nicht verarbeitet. Es wurden keine lokalen, auf den Benutzer zugeschnittene Objekte materialisiert/geändert, und eine Identitätsauflösung ist nicht aufgetreten. Wenn EndExecute aufgerufen wird, wird ein DataServiceResponse erstellt und zurückgegeben, aber die Ergebnisse wurden immer noch nicht verarbeitet. Identitätsauflösung, Objektmaterialisierung und Manipulation treten nur auf, wenn der Benutzer die Ergebnisse auflistet.
