DataServiceContext.BeginGetReadStream Método (Object, DataServiceRequestArgs, AsyncCallback, Object)
Obtiene de forma asincrónica el flujo de datos binarios que pertenece a la entidad especificada, usando los encabezados de mensaje especificados.
Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Sintaxis
'Declaración
Public Function BeginGetReadStream ( _
entity As Object, _
args As DataServiceRequestArgs, _
callback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Uso
Dim instance As DataServiceContext
Dim entity As Object
Dim args As DataServiceRequestArgs
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginGetReadStream(entity, _
args, callback, state)
public IAsyncResult BeginGetReadStream(
Object entity,
DataServiceRequestArgs args,
AsyncCallback callback,
Object state
)
public:
IAsyncResult^ BeginGetReadStream(
Object^ entity,
DataServiceRequestArgs^ args,
AsyncCallback^ callback,
Object^ state
)
member BeginGetReadStream :
entity:Object *
args:DataServiceRequestArgs *
callback:AsyncCallback *
state:Object -> IAsyncResult
public function BeginGetReadStream(
entity : Object,
args : DataServiceRequestArgs,
callback : AsyncCallback,
state : Object
) : IAsyncResult
Parámetros
- entity
Tipo: System.Object
Entidad que tiene el flujo de datos binarios que se va a recuperar.
- args
Tipo: System.Data.Services.Client.DataServiceRequestArgs
Instancia de la clase DataServiceRequestArgs que contiene la configuración para el mensaje de solicitud HTTP.
- callback
Tipo: System.AsyncCallback
Delegado que se va a invocar cuando los resultados estén disponibles para consumo del cliente.
- state
Tipo: System.Object
Objeto de estados definido por el usuario pasado a la devolución de llamada.
Valor devuelto
Tipo: System.IAsyncResult
Objeto IAsyncResult que se usa para realizar un seguimiento del estado de la operación asincrónica.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | Cualquiera de los parámetros proporcionado al método es nulles una referencia NULL (Nothing en Visual Basic).. |
| ArgumentException | Este DataServiceContext no realiza el seguimiento de entity. O bien entity se encuentra en el estado Added. O bien entity no es una entrada de vínculo multimedia y no tiene un flujo de datos binarios relacionado. |
Comentarios
El método GetReadStream solicita asincrónicamente el flujo de datos binarios que pertenece al parámetro entity solicitado.
En el protocolo AtomPub, entity es una entrada de vínculo de multimedia y el flujo de datos binarios es el recurso multimedia asociado.
No se realiza ninguna validación en los encabezados que se establecen en args. Por tanto, no modifique un encabezado HTTP de manera que cambie el significado de la solicitud.