DataServiceContext.BeginGetReadStream Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém de forma assíncrona os dados da propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos da mensagem especificada.
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 -> IAsyncResultPublic Function BeginGetReadStream (entity As Object, args As DataServiceRequestArgs, callback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- entity
- Object
A entidade que tem a propriedade binária a ser recuperada.
Instância da classe DataServiceRequestArgs que contém configurações para a mensagem de solicitação HTTP.
- callback
- AsyncCallback
Delegado a ser invocado quando os resultados estiverem disponíveis para consumo do cliente.
- state
- Object
Objeto de estado definido pelo usuário passado ao retorno de chamada.
Retornos
Um objeto IAsyncResult que é usado para acompanhar o status da operação assíncrona.
Exceções
Qualquer um dos parâmetros fornecidos ao método é null.
O entity não é acompanhado por este DataServiceContext.
- ou -
A entity está no estado Added.
- ou -
A entity não é uma Entrada de Link de Mídia e não tem uma propriedade binária.
Comentários
O GetReadStream método solicita de forma assíncrona um fluxo de dados que contém a propriedade binária do solicitado entity.
No protocolo AtomPub, o entity é uma Entrada de Link de Mídia e a propriedade binária é o Recurso de Mídia associado.
Nenhuma validação é executada nos cabeçalhos definidos em args. Portanto, não altere um cabeçalho HTTP de uma maneira que altere o significado da solicitação.
