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.