DataServiceCollection<T>.LoadAsync-Methode
Lädt Elemente asynchron in die Auflistung, wenn diese die Navigationseigenschaft einer Entität darstellt.
Wird nur vom WCF Data Services 5.0-Client für Silverlight unterstützt.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Sub LoadAsync
'Usage
Dim instance As DataServiceCollection
instance.LoadAsync()
public void LoadAsync()
public:
void LoadAsync()
member LoadAsync : unit -> unit
public function LoadAsync()
Ausnahmen
Ausnahme | Bedingung |
---|---|
InvalidOperationException | Wenn die Auflistung keiner übergeordneten Entität angehört. - oder - Wenn die übergeordnete Entität nicht von DataServiceContext nachverfolgt wird. - oder - Wenn ein vorheriger Aufruf von LoadAsync noch nicht abgeschlossen ist. |
Hinweise
Wenn Sie das Dialogfeld Dienstverweis hinzufügen oder das Tool DataSvcUtil.exe mit der Option /binding verwenden, um die Clientdatendienstklassen zu erzeugen, werden Navigationseigenschaften, die eine Auflistung zurückgeben, als Instanzen von DataServiceCollection<T> generiert. Wenn eine Instanz von DataServiceCollection<T> von einer solchen Eigenschaft abgerufen wird, wird die LoadAsync-Methode verwendet, um die verknüpften Entitäten aus dem Datendienst in die Auflistung zu laden.
Da die LoadAsync-Methode asynchron ist, erfolgt die Rückgabe der Methode, bevor eine Antwort auf den Datendienst empfangen wird. Sie müssen das LoadCompleted-Ereignis behandeln, um auf die QueryOperationResponse<T> zugreifen zu können, die Informationen zu den Ergebnissen des Ladevorgangs enthält. Elemente werden nach Abschluss des Ladevorgangs in die Auflistung geladen, unabhängig davon, ob das LoadCompleted-Ereignis behanelt wurde.
Die LoadAsync-Methode kann auf dem UI-Thread nur einmal aufgerufen werden. Die Methode kann erst nach dem Auslösen des LoadCompleted-Ereignisses erneut aufgerufen werden. Das LoadCompleted-Ereignis wird unabhängig davon ausgelöst, ob die Abfrage erfolgreich durchgeführt wird.