DataServiceContext.SetSaveStream Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.Services.Client
Assembly:
System.Data.Services.Client.dll

Imposta un nuovo flusso di dati come proprietà binaria di un'entità.

Overload

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Imposta un nuovo flusso di dati come proprietà binaria di un'entità, con le impostazioni specificate nel messaggio di richiesta.
SetSaveStream(Object, Stream, Boolean, String, String)

Imposta un nuovo flusso di dati come proprietà binaria di un'entità. Le intestazioni Content-Type e Slug specificate sono incluse nel messaggio di richiesta.

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Imposta un nuovo flusso di dati come proprietà binaria di un'entità, con le impostazioni specificate nel messaggio di richiesta.

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)

Parametri

entity
Object

Entità che dispone di una proprietà binaria alla quale assegnare il flusso di dati.

stream
Stream

oggetto Stream da cui leggere i dati binari.

closeStream
Boolean

Valore Boolean che determina se il flusso di dati è chiuso al completamento del metodo SaveChanges().

args
DataServiceRequestArgs

Istanza della classe DataServiceRequestArgs contenente impostazioni per il messaggio della richiesta HTTP.

Eccezioni

ArgumentNullException

Uno dei parametri forniti al metodo è null.

ArgumentException

entity non viene rilevato da questa istanza di DataServiceContext.

-oppure-

All'oggetto entity viene applicato l'oggetto MediaEntryAttribute.

Commenti

Il SetSaveStream metodo imposta il flusso binario che è la risorsa multimediale associata a entity, che viene chiamata voce collegamento multimediale.

La chiamata del metodo SetSaveStream contrassegna l'entità come voce di collegamento multimediale. Anche lo stato dell'entità viene impostato su Modified in modo che il flusso venga inviato al servizio dati alla successiva chiamata del metodo SaveChanges.

Il metodo SetSaveStream legge Stream dall'inizio alla fine. Nell'oggetto Seek non viene tentata un'operazione Stream.

Quando closeStream è true, il metodo chiude il SaveChanges flusso prima che venga restituito. Il flusso viene inoltre chiuso se si verifica un errore di lettura.

Se all'oggetto entity viene applicato l'oggetto MediaEntryAttribute, la risorsa multimediale non può essere un flusso di dati. Rimuovere questo attributo prima di tentare di impostare il flusso di dati per entity.

Non viene eseguita alcuna convalida delle intestazioni impostate in args. Non modificare pertanto un'intestazione HTTP in un modo che determinerebbe la modifica del significato della richiesta.

Si applica a

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

Imposta un nuovo flusso di dati come proprietà binaria di un'entità. Le intestazioni Content-Type e Slug specificate sono incluse nel messaggio di richiesta.

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)

Parametri

entity
Object

Entità che dispone di una proprietà binaria alla quale assegnare il flusso di dati.

stream
Stream

oggetto Stream da cui leggere i dati binari.

closeStream
Boolean

Valore Boolean che determina se il flusso di dati è chiuso al completamento del metodo SaveChanges().

contentType
String

Valore dell'intestazione Content-Type per il messaggio di richiesta.

slug
String

Valore dell'intestazione Slug per il messaggio di richiesta.

Eccezioni

ArgumentNullException

Uno dei parametri forniti al metodo è null.

ArgumentException

entity non viene rilevato da questa istanza di DataServiceContext.

-oppure-

All'oggetto entity viene applicato l'oggetto MediaEntryAttribute.

Commenti

Il SetSaveStream metodo imposta il flusso binario che è la risorsa multimediale associata a entity, che viene chiamata voce collegamento multimediale.

La chiamata del metodo SetSaveStream contrassegna l'entità come voce di collegamento multimediale. Anche lo stato dell'entità viene impostato su Modified in modo che il flusso venga inviato al servizio dati alla successiva chiamata del metodo SaveChanges.

Il metodo SetSaveStream legge Stream dall'inizio alla fine. Nell'oggetto Seek non viene tentata un'operazione Stream.

Quando closeStream è true, il metodo chiude il SaveChanges flusso prima che venga restituito. Il flusso viene inoltre chiuso se si verifica un errore di lettura.

Se all'oggetto entity viene applicato l'oggetto MediaEntryAttribute, la risorsa multimediale non può essere un flusso di dati. Rimuovere questo attributo prima di tentare di impostare il flusso di dati per entity.

Non viene eseguita alcuna convalida delle intestazioni impostate in contentType e slug. Non modificare pertanto queste intestazioni HTTP in un modo che determinerebbe la modifica del significato della richiesta.

Si applica a