Metodo DataServiceContext.SetSaveStream (Object, Stream, Boolean, String, String)
Imposta un flusso di dati binari appartenente all'entità specificata con le intestazioni Content-Type e Slug 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, _
contentType As String, _
slug As String _
)
'Utilizzo
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
)
Parametri
- entity
Tipo: System.Object
Entità a cui appartiene il flusso di dati.
- 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.
- contentType
Tipo: System.String
Valore dell'intestazione Content-Type per il messaggio di richiesta.
- slug
Tipo: System.String
Valore dell'intestazione Slug per il messaggio di richiesta.
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 contentType e slug. Non modificare pertanto queste intestazioni HTTP in un modo che determinerebbe la modifica del significato della richiesta.