Partilhar via


DataServiceContext.SetSaveStream Método

Definição

Define um novo fluxo de dados como a propriedade binária de uma entidade.

Sobrecargas

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Define um novo fluxo de dados como a propriedade binária de uma entidade, com as configurações especificadas na mensagem de solicitação.

SetSaveStream(Object, Stream, Boolean, String, String)

Define um novo fluxo de dados como a propriedade binária de uma entidade. Os cabeçalhos Content-Type e Slug especificados são incluídos na mensagem de solicitação.

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Define um novo fluxo de dados como a propriedade binária de uma entidade, com as configurações especificadas na mensagem de solicitação.

public:
 void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::Data::Services::Client::DataServiceRequestArgs ^ args);
public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, System.Data.Services.Client.DataServiceRequestArgs args);
member this.SetSaveStream : obj * System.IO.Stream * bool * System.Data.Services.Client.DataServiceRequestArgs -> unit
Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)

Parâmetros

entity
Object

A entidade que tem uma propriedade binária à qual atribuir o fluxo de dados.

stream
Stream

O Stream do qual ler os dados binários.

closeStream
Boolean

Um valor Boolean que determina se o fluxo de dados é fechado quando o método SaveChanges() é concluído.

args
DataServiceRequestArgs

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

Exceções

Qualquer um dos parâmetros fornecidos ao método é null.

A entity não está sendo acompanhada por esta instância DataServiceContext.

- ou -

A entity tem o MediaEntryAttribute aplicado.

Comentários

O SetSaveStream método define o fluxo binário que é o Recurso de Mídia associado ao entity, que é chamado de Entrada de Link de Mídia.

Chamar o SetSaveStream método marca a entidade como uma Entrada de Link de Mídia. O estado da entidade também é definido como para Modified que o fluxo seja enviado ao serviço de dados na próxima vez que o SaveChanges método for chamado.

O SetSaveStream método lê o Stream até o final. Uma Seek operação não é testada no Stream.

Quando closeStream é true, o SaveChanges método fecha o fluxo antes de retornar. O fluxo é fechado mesmo quando ocorre um erro e o fluxo não é lido.

Quando o entity tiver MediaEntryAttribute aplicado, o Recurso de Mídia não poderá ser um fluxo de dados. Remova esse atributo antes de tentar definir o fluxo de dados para o entity.

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.

Aplica-se a

SetSaveStream(Object, Stream, Boolean, String, String)

Define um novo fluxo de dados como a propriedade binária de uma entidade. Os cabeçalhos Content-Type e Slug especificados são incluídos na mensagem de solicitação.

public:
 void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::String ^ contentType, System::String ^ slug);
public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, string contentType, string slug);
member this.SetSaveStream : obj * System.IO.Stream * bool * string * string -> unit
Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)

Parâmetros

entity
Object

A entidade que tem uma propriedade binária à qual atribuir o fluxo de dados.

stream
Stream

O Stream do qual ler os dados binários.

closeStream
Boolean

Um valor Boolean que determina se o fluxo de dados é fechado quando o método SaveChanges() é concluído.

contentType
String

O valor do cabeçalho Content-Type da mensagem de solicitação.

slug
String

O valor do cabeçalho Slug para a mensagem de solicitação.

Exceções

Qualquer um dos parâmetros fornecidos ao método é null.

A entity não está sendo acompanhada por esta instância DataServiceContext.

- ou -

A entity tem o MediaEntryAttribute aplicado.

Comentários

O SetSaveStream método define o fluxo binário que é o Recurso de Mídia associado ao entity, que é chamado de Entrada de Link de Mídia.

Chamar o SetSaveStream método marca a entidade como Entrada de Link de Mídia. O estado da entidade também é definido como para Modified que o fluxo seja enviado ao serviço de dados na próxima vez que o SaveChanges método for chamado.

O SetSaveStream método lê o Stream até o final. Uma Seek operação não é testada no Stream.

Quando closeStream é true, o SaveChanges método fecha o fluxo antes de retornar. O fluxo é fechado mesmo quando ocorre um erro e o fluxo não é lido.

Quando o entity tiver MediaEntryAttribute aplicado, o Recurso de Mídia não poderá ser um fluxo de dados. Remova esse atributo antes de tentar definir o fluxo de dados para o entity.

Nenhuma validação é executada nos cabeçalhos definidos em contentType e slug. Portanto, não altere esses cabeçalhos HTTP de uma forma que altere o significado da solicitação.

Aplica-se a