Compartir a través de


DataServiceCollection<T>.LoadAsync Método

Carga elementos en la colección de forma asincrónica cuando representa la propiedad de navegación de una entidad.

Compatible solo con el cliente de WCF Data Services 5.0 para Silverlight.

Espacio de nombres:  System.Data.Services.Client
Ensamblado:  Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)

Sintaxis

'Declaración
Public Sub LoadAsync
'Uso
Dim instance As DataServiceCollection

instance.LoadAsync()
public void LoadAsync()
public:
void LoadAsync()
member LoadAsync : unit -> unit 
public function LoadAsync()

Excepciones

Excepción Condición
InvalidOperationException

Cuando la colección no pertenece a una entidad primaria.

O bien

Cuando DataServiceContext no realiza el seguimiento de la entidad primaria.

O bien

Cuando todavía no se ha completado una llamada anterior a LoadAsync.

Comentarios

Cuando usa el cuadro de diálogo Agregar referencia de servicio o la herramienta DataSvcUtil.exe con la opción /binding para generar las clases del servicio de datos cliente, las propiedades de navegación que devuelven una colección se generan como instancias de DataServiceCollection<T>. Cuando se obtiene una instancia de DataServiceCollection<T> de una de esas propiedades, se usa el método LoadAsync para cargar las entidades relacionadas del servicio de datos en la colección.

Como el método LoadAsync es asincrónico, vuelve antes de que se reciba una respuesta en el servicio de datos. Debe controlar el evento LoadCompleted para obtener acceso a la QueryOperationResponse<T> que contiene información sobre el resultado de la operación de carga. Los elementos se cargan en la colección cuando se completa la operación de carga, independientemente de que el evento LoadCompleted se haya controlado o no.

Solo se puede llamar una vez al método LoadAsync en el subproceso de la interfaz de usuario. No se puede volver a llamar al método hasta que no se haya producido el evento LoadCompleted. El evento LoadCompleted se produce independientemente de que la consulta se realice correctamente o no.

Vea también

Referencia

DataServiceCollection<T> Clase

Sobrecarga de LoadAsync

Espacio de nombres System.Data.Services.Client