DataServiceContext.SetSaveStream Método (Object, Stream, Boolean, String, String)
Establece un flujo de datos binarios que pertenece a la entidad especificada, con los encabezados Content-Type y Slug 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, _
contentType As String, _
slug As String _
)
'Uso
Dim instance As DataServiceContext
Dim entity As Object
Dim stream As Stream
Dim closeStream As Boolean
Dim contentType As String
Dim slug As String
instance.SetSaveStream(entity, stream, _
closeStream, contentType, slug)
public void SetSaveStream(
Object entity,
Stream stream,
bool closeStream,
string contentType,
string slug
)
public:
void SetSaveStream(
Object^ entity,
Stream^ stream,
bool closeStream,
String^ contentType,
String^ slug
)
member SetSaveStream :
entity:Object *
stream:Stream *
closeStream:bool *
contentType:string *
slug:string -> unit
public function SetSaveStream(
entity : Object,
stream : Stream,
closeStream : boolean,
contentType : String,
slug : String
)
Parámetros
- entity
Tipo: System.Object
Entidad a la que pertenece el flujo de datos.
- 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.
- contentType
Tipo: System.String
Valor del encabezado Content-Type para el mensaje de solicitud.
- slug
Tipo: System.String
Valor del encabezado Slug para el mensaje de solicitud.
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 contentType y slug. Por tanto, no modifique estos encabezados HTTP de manera que cambie el significado de la solicitud.