Metodo DataServiceContext.SetSaveStream (Object, Stream, Boolean, DataServiceRequestArgs)
Imposta un flusso di dati binari per l'entità specificata con le intestazioni specificate nel messaggio di richiesta.
Spazio dei nomi System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Sintassi
'Dichiarazione
Public Sub SetSaveStream ( _
entity As Object, _
stream As Stream, _
closeStream As Boolean, _
args As DataServiceRequestArgs _
)
'Utilizzo
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
)
Parametri
- entity
Tipo: System.Object
Entità a cui appartiene il flusso di dati binari.
- stream
Tipo: System.IO.Stream
oggetto Stream da cui leggere i dati binari.
- closeStream
Tipo: System.Boolean
Valore Boolean che determina se il flusso di dati è chiuso al completamento del metodo SaveChanges.
- args
Tipo: System.Data.Services.Client.DataServiceRequestArgs
Istanza della classe DataServiceRequestArgs contenente impostazioni per il messaggio della richiesta HTTP.
Eccezioni
| Eccezione | Condizione |
|---|---|
| ArgumentNullException | Qualsiasi parametro fornito al metodo è Null. |
| ArgumentException | entity non viene rilevato da questa istanza di DataServiceContext. -oppure- All'oggetto entity viene applicato l'oggetto MediaEntryAttribute. |
Osservazioni
Il metodo SetSaveStream imposta il flusso di dati binari corrispondente alla risorsa multimediale appartenente all'oggetto entity, denominato voce di 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 Stream non viene tentata un'operazione Seek.
Se closeStream è true, il metodo SaveChanges chiude il 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.