Metodo DataServiceCollection<T>.LoadAsync
Carica elementi nella raccolta in modo asincrono, quando rappresenta la proprietà di navigazione di un'entità.
Supportato unicamente dal client di WCF Data Services 5.0 per Silverlight.
Spazio dei nomi System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Sintassi
'Dichiarazione
Public Sub LoadAsync
'Utilizzo
Dim instance As DataServiceCollection
instance.LoadAsync()
public void LoadAsync()
public:
void LoadAsync()
member LoadAsync : unit -> unit
public function LoadAsync()
Eccezioni
| Eccezione | Condizione |
|---|---|
| InvalidOperationException | Quando la raccolta non appartiene a un'entità padre. -oppure- Quando l'entità padre non viene rilevata dall'oggetto DataServiceContext. -oppure- Quando una chiamata precedente al metodo LoadAsync non è ancora completa. |
Osservazioni
Quando si utilizza la finestra di dialogo Aggiungi riferimento al servizio o lo strumento DataSvcUtil.exe con l'opzione /binding per generare le classi del servizio dati client, le proprietà di navigazione che restituiscono una raccolta vengono generate come istanze dell'oggetto DataServiceCollection<T>. Quando un'istanza dell'oggetto DataServiceCollection<T> viene ottenuto da questo tipo di proprietà, il metodo LoadAsync viene utilizzato per caricare le entità correlate dal servizio dati nella raccolta.
Poiché il metodo LoadAsync è asincrono, la restituzione da parte di quest'ultimo viene effettuata prima della ricezione di una risposta al servizio dati. È necessario gestire l'evento LoadCompleted per accedere all'oggetto QueryOperationResponse<T> che contiene informazioni sul risultato dell'operazione di caricamento. Gli elementi vengono caricati nella raccolta quando l'operazione di caricamento è completa indipendentemente dalla gestione dell'evento LoadCompleted.
Il metodo LoadAsync può essere chiamato solo una volta sul thread dell'interfaccia utente. Il metodo può essere chiamato di nuovo solo dopo la generazione dell'evento LoadCompleted. L'evento LoadCompleted viene generato indipendentemente dal corretto completamento della query.