DataServiceContext.SetSaveStream 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.
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 -> unitPublic 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.
- closeStream
- Boolean
Um valor Boolean que determina se o fluxo de dados é fechado quando o método SaveChanges() é concluído.
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 -> unitPublic 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.
- 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.
