DataServiceContext.SetSaveStream DataServiceContext.SetSaveStream DataServiceContext.SetSaveStream Method

Definición

Establece un nuevo flujo de datos como propiedad binaria de una entidad.Sets a new data stream as the binary property of an entity.

Sobrecargas

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Establece un nuevo flujo de datos como propiedad binaria de una entidad, con los valores especificados en el mensaje de solicitud.Sets a new data stream as the binary property of an entity, with the specified settings in the request message.

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

Establece un nuevo flujo de datos como propiedad binaria de una entidad.Sets a new data stream as the binary property of an entity. Los encabezados Content-Type y Slug se incluyen en el mensaje de solicitud.The specified Content-Type and Slug headers are included in the request message.

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Establece un nuevo flujo de datos como propiedad binaria de una entidad, con los valores especificados en el mensaje de solicitud.Sets a new data stream as the binary property of an entity, with the specified settings in the request message.

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

Parámetros

entity
Object Object Object

Entidad que tiene una propiedad binaria a la que se va a asignar el flujo de datos.The entity that has a binary property to which to assign the data stream.

stream
Stream Stream Stream

Stream desde el que se van a leer los datos binarios.The Stream from which to read the binary data.

closeStream
Boolean Boolean Boolean

Valor Boolean que determina si se cierra el flujo de datos cuando se completa el método SaveChanges().A Boolean value that determines whether the data stream is closed when the SaveChanges() method is completed.

args
DataServiceRequestArgs DataServiceRequestArgs DataServiceRequestArgs

Instancia de la clase DataServiceRequestArgs que contiene la configuración para el mensaje de solicitud HTTP.An instance of the DataServiceRequestArgs class that contains settings for the HTTP request message.

Excepciones

Algunos de los parámetros proporcionados al método son null.Any of the parameters supplied to the method are null.

Esta instancia de entity no está realizando el seguimiento de DataServiceContext.The entity is not being tracked by this DataServiceContext instance.

O bien-or- entity tiene aplicado MediaEntryAttribute.The entity has the MediaEntryAttribute applied.

Comentarios

El SetSaveStream método establece el flujo binario que es el recurso multimedia que está asociado el entity, que se denomina una entrada de vínculo multimedia.The SetSaveStream method sets the binary stream that is the Media Resource that is associated with the entity, which is called a Media Link Entry.

Al llamar al método SetSaveStream se marca la entidad como una entrada de vínculo multimedia.Calling the SetSaveStream method marks the entity as a Media Link Entry. 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.The entity state is also set to Modified so that the stream will be sent to the data service the next time that the SaveChanges method is called.

El método SetSaveStream lee Stream hasta el final.The SetSaveStream method reads the Stream through to the end. Una operación Seek no se intenta en Stream.A Seek operation is not tried on the Stream.

Cuando closeStream es true, el SaveChanges método cierra la secuencia antes de devolver.When closeStream is true, the SaveChanges method closes the stream before it returns. El flujo se cierra aunque se produzca un error y no se lea el flujo.The stream is closed even when an error occurs and the stream is not read.

Cuando entity tiene aplicado MediaEntryAttribute, el recurso multimedia no puede ser un flujo de datos.When the entity has the MediaEntryAttribute applied, the Media Resource cannot be a data stream. Quite este atributo antes de intentar establecer el flujo de datos de entity.Remove this attribute before you try to set the data stream for the entity.

No se realiza ninguna validación en los encabezados que se establecen en args.No validation is performed on the headers that are set in args. Por tanto, no modifique un encabezado HTTP de manera que cambie el significado de la solicitud.Therefore, do not change an HTTP header in a way that changes the meaning of the request.

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

Establece un nuevo flujo de datos como propiedad binaria de una entidad.Sets a new data stream as the binary property of an entity. Los encabezados Content-Type y Slug se incluyen en el mensaje de solicitud.The specified Content-Type and Slug headers are included in the request message.

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

Parámetros

entity
Object Object Object

Entidad que tiene una propiedad binaria a la que se va a asignar el flujo de datos.The entity that has a binary property to which to assign the data stream.

stream
Stream Stream Stream

Stream desde el que se van a leer los datos binarios.The Stream from which to read the binary data.

closeStream
Boolean Boolean Boolean

Valor Boolean que determina si se cierra el flujo de datos cuando se completa el método SaveChanges().A Boolean value that determines whether the data stream is closed when the SaveChanges() method is completed.

contentType
String String String

Valor del encabezado Content-Type para el mensaje de solicitud.The Content-Type header value for the request message.

slug
String String String

Valor del encabezado Slug para el mensaje de solicitud.The Slug header value for the request message.

Excepciones

Algunos de los parámetros proporcionados al método son null.Any of the parameters supplied to the method are null.

Esta instancia de entity no está realizando el seguimiento de DataServiceContext.The entity is not being tracked by this DataServiceContext instance.

O bien-or- entity tiene aplicado MediaEntryAttribute.The entity has the MediaEntryAttribute applied.

Comentarios

El SetSaveStream método establece el flujo binario que es el recurso multimedia que está asociado el entity, que se denomina una entrada de vínculo multimedia.The SetSaveStream method sets the binary stream that is the Media Resource that is associated with the entity, which is called a Media Link Entry.

Al llamar al método SetSaveStream se marca la entidad como una entrada de vínculo multimedia.Calling the SetSaveStream method marks the entity as Media Link Entry. 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.The entity state is also set to Modified so that the stream will be sent to the data service the next time that the SaveChanges method is called.

El método SetSaveStream lee Stream hasta el final.The SetSaveStream method reads the Stream through to the end. Una operación Seek no se intenta en Stream.A Seek operation is not tried on the Stream.

Cuando closeStream es true, el SaveChanges método cierra la secuencia antes de devolver.When closeStream is true, the SaveChanges method closes the stream before it returns. El flujo se cierra aunque se produzca un error y no se lea el flujo.The stream is closed even when an error occurs and the stream is not read.

Cuando entity tiene aplicado MediaEntryAttribute, el recurso multimedia no puede ser un flujo de datos.When the entity has the MediaEntryAttribute applied, the Media Resource cannot be a data stream. Quite este atributo antes de intentar establecer el flujo de datos de entity.Remove this attribute before you try to set the data stream for the entity.

No se realiza ninguna validación en los encabezados que se establecen en contentType y slug.No validation is performed on the headers that are set in contentType and slug. Por tanto, no modifique estos encabezados HTTP de manera que cambie el significado de la solicitud.Therefore, do not change these HTTP headers in a way that changes the meaning of the request.

Se aplica a