Méthode DataServiceCollection<T>.LoadAsync
Charge des éléments de façon asynchrone dans la collection, lorsqu'elle représente la propriété de navigation d'une entité.
Pris en charge uniquement par le cliente WCF Data Services 5.0 pour Silverlight.
Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Syntaxe
'Déclaration
Public Sub LoadAsync
'Utilisation
Dim instance As DataServiceCollection
instance.LoadAsync()
public void LoadAsync()
public:
void LoadAsync()
member LoadAsync : unit -> unit
public function LoadAsync()
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | Lorsque la collection n'appartient pas à une entité parente. ou Lorsque l'entité parente n'est pas suivie par le DataServiceContext. ou Lorsqu'un précédent appel de LoadAsync n'est pas encore terminé. |
Notes
Lorsque vous utilisez la boîte de dialogue Ajouter une référence de service ou l'outil DataSvcUtil.exe avec l'option /binding pour générer les classes du service de données client, les propriétés de navigation qui retournent une collection sont générées en tant qu'instances de DataServiceCollection<T>. Lorsqu'une instance de DataServiceCollection<T> est obtenue de ce type de propriété, la méthode LoadAsync est utilisée pour charger les entités liées depuis le service de données vers la collection.
Étant donné que la méthode LoadAsync est asynchrone, elle retourne un résultat avant que la réponse au service de données ne soit reçue. Vous devez gérer l'événement LoadCompleted afin d'accéder à QueryOperationResponse<T>, qui contient des informations sur le résultat de l'opération de chargement. Les éléments sont chargés dans la collection lorsque l'opération de chargement est terminée, que l'événement LoadCompleted soit géré ou non.
La méthode LoadAsync peut être appelée une seule fois sur le thread d'interface utilisateur. Elle ne peut plus être appelée à nouveau jusqu'à ce que l'événement LoadCompleted soit déclenché. L'événement LoadCompleted est déclenché, que la requête soit réussie ou non.