DataServiceContext.BeginGetReadStream Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
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
Objeto IAsyncResult que se usa para realizar un seguimiento del estado de la operación asincrónica.
Excepciones
Alguno de los parámetros proporcionados al método es null.
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.