DataServiceContext.SetSaveStream Método (Object, Stream, Boolean, DataServiceRequestArgs)
Establece un flujo de datos binarios para la entidad especificada, con los encabezados especificados en el mensaje de solicitud.
Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Sintaxis
'Declaración
Public Sub SetSaveStream ( _
entity As Object, _
stream As Stream, _
closeStream As Boolean, _
args As DataServiceRequestArgs _
)
'Uso
Dim instance As DataServiceContext
Dim entity As Object
Dim stream As Stream
Dim closeStream As Boolean
Dim args As DataServiceRequestArgs
instance.SetSaveStream(entity, stream, _
closeStream, args)
public void SetSaveStream(
Object entity,
Stream stream,
bool closeStream,
DataServiceRequestArgs args
)
public:
void SetSaveStream(
Object^ entity,
Stream^ stream,
bool closeStream,
DataServiceRequestArgs^ args
)
member SetSaveStream :
entity:Object *
stream:Stream *
closeStream:bool *
args:DataServiceRequestArgs -> unit
public function SetSaveStream(
entity : Object,
stream : Stream,
closeStream : boolean,
args : DataServiceRequestArgs
)
Parámetros
- entity
Tipo: System.Object
Entidad a la que pertenece el flujo binario.
- stream
Tipo: System.IO.Stream
Stream desde el que se van a leer los datos binarios.
- closeStream
Tipo: System.Boolean
Valor Boolean que determina si se cierra el flujo de datos cuando se completa el método SaveChanges.
- args
Tipo: System.Data.Services.Client.DataServiceRequestArgs
Instancia de la clase DataServiceRequestArgs que contiene la configuración para el mensaje de solicitud HTTP.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | Cualquiera de los parámetros proporcionados al método es nulles una referencia NULL (Nothing en Visual Basic).. |
| ArgumentException | Esta instancia de DataServiceContext no está realizando el seguimiento de entity. O bien entity tiene aplicado MediaEntryAttribute. |
Comentarios
El método SetSaveStream establece el flujo binario que es el recurso multimedia perteneciente a entity, que se denomina una entrada de vínculo multimedia.
Al llamar al método SetSaveStream se marca la entidad como una entrada de vínculo multimedia. El estado de entidad también se establece en Modified para que el flujo se envíe al servicio de datos la próxima vez que se llame al método SaveChanges.
El método SetSaveStream lee Stream hasta el final. Una operación Seek no se intenta en Stream.
Cuando closeStream es true, el método SaveChanges cierra el flujo antes de volver. El flujo se cierra aunque se produzca un error y no se lea el flujo.
Cuando entity tiene aplicado MediaEntryAttribute, el recurso multimedia no puede ser un flujo de datos. Quite este atributo antes de intentar establecer el flujo de datos de entity.
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.