DataServiceContext.BeginGetReadStream Método

Definición

Espacio de nombres:

System.Data.Services.Client

Ensamblado:

System.Data.Services.Client.dll

Obtiene de manera asincrónica los datos de propiedad binarios de la entidad especificada como un flujo de datos junto con los encabezados del mensaje especificados.

public:
 IAsyncResult ^ BeginGetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginGetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args, AsyncCallback callback, object state);

member this.BeginGetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs * AsyncCallback * obj -> IAsyncResult

Public Function BeginGetReadStream (entity As Object, args As DataServiceRequestArgs, callback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

entity

Object

Entidad que tiene la propiedad binaria que se va a recuperar.

args

DataServiceRequestArgs

Instancia de la clase DataServiceRequestArgs que contiene la configuración para el mensaje de solicitud HTTP.

callback

AsyncCallback

Delegado que se va a invocar cuando los resultados estén disponibles para consumo del cliente.

state

Object

Objeto de estados definido por el usuario pasado a la devolución de llamada.

Devoluciones

IAsyncResult

Objeto IAsyncResult que se usa para realizar un seguimiento del estado de la operación asincrónica.

Excepciones

ArgumentNullException

Alguno de los parámetros proporcionados al método es null.

ArgumentException

Este entity no realiza el seguimiento de DataServiceContext.

o bien

entity se encuentra en el estado Added.

o bien

entity no es una entrada de vínculo multimedia y no tiene una propiedad binaria.

Comentarios

El GetReadStream método solicita de forma asincrónica un flujo de datos que contiene la propiedad binaria del objeto solicitado entity.

En el protocolo AtomPub, entity es una entrada de vínculo multimedia y la propiedad binaria 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.