DataServiceContext.GetReadStream Método

Definição

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados.

Sobrecargas

GetReadStream(Object)	Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados.
GetReadStream(Object, DataServiceRequestArgs)	Obtém os dados de propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos da mensagem especificada.
GetReadStream(Object, String)	Obtém os dados de propriedade binária para a entidade especificada como um fluxo de dados, com o cabeçalho da mensagem Accept.

GetReadStream(Object)

Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados.

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity);

member this.GetReadStream : obj -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object) As DataServiceStreamResponse

Parâmetros

entity

Object

A entidade que tem a propriedade binária a ser recuperada.

Retornos

DataServiceStreamResponse

Uma instância de DataServiceStreamResponse que representa a resposta.

Exceções

ArgumentNullException

O entity é null.

ArgumentException

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 sí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.

GetReadStream(Object, DataServiceRequestArgs)

Obtém os dados de propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos da mensagem especificada.

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args);

member this.GetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, args As DataServiceRequestArgs) As DataServiceStreamResponse

Parâmetros

entity

Object

A entidade que tem a propriedade binária a ser recuperada.

args

DataServiceRequestArgs

Instância da classe DataServiceRequestArgs que contém configurações para a mensagem de solicitação HTTP.

Retornos

DataServiceStreamResponse

Uma instância de DataServiceStreamResponse que representa a resposta.

Exceções

ArgumentNullException

entity é null.

- ou -

args é null.

ArgumentException

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 sí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 forma que altere o significado da solicitação.

GetReadStream(Object, String)

Obtém os dados de propriedade binária para a entidade especificada como um fluxo de dados, com o cabeçalho da mensagem Accept.

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::String ^ acceptContentType);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity, string acceptContentType);

member this.GetReadStream : obj * string -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, acceptContentType As String) As DataServiceStreamResponse

Parâmetros

entity

Object

A entidade que tem a propriedade binária a ser recuperada.

acceptContentType

String

O tipo de conteúdo dos dados solicitados do serviço de dados, especificado no cabeçalho Accept.

Retornos

DataServiceStreamResponse

Uma instância de DataServiceStreamResponse que representa a resposta.

Exceções

ArgumentNullException

entity é null.

- ou -

acceptContentType é null.

ArgumentException

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 acceptContentType parâmetro deve ser um valor válido para o cabeçalho Aceitar HTTP.

O GetReadStream método solicita de forma sí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 acceptContentType. Portanto, não altere esse cabeçalho HTTP de uma forma que altere o significado da solicitação.