DataServiceContext.SetSaveStream-Methode (Object, Stream, Boolean, DataServiceRequestArgs)

Legt einen binären Datenstrom für die angegebene Entität fest, mit den angegebenen Headern in der Anforderungsmeldung.

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)

Syntax

'Declaration
Public Sub SetSaveStream ( _
    entity As Object, _
    stream As Stream, _
    closeStream As Boolean, _
    args As DataServiceRequestArgs _
)
'Usage
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
)

Parameter

• entity
  Typ: System.Object
  Die Entität, zu der der binäre Strom gehört.

• stream
  Typ: System.IO.Stream
  Der Stream, von dem die binären Daten gelesen werden sollen.

• closeStream
  Typ: System.Boolean
  Ein Boolean-Wert, der bestimmt, ob der Datenstrom geschlossen wird, wenn die SaveChanges-Methode abgeschlossen wird.

• args
  Typ: System.Data.Services.Client.DataServiceRequestArgs
  Instanz der Klasse DataServiceRequestArgs, die Einstellungen für die HTTP-Anforderungsmeldung enthält.

Ausnahmen

Hinweise

Die SetSaveStream-Methode legt den binären Strom fest, der die Medienressource ist, die zum entity gehört, der als Medienlinkeintrag bezeichnet wird.

Die SetSaveStream-Methode aufzurufen markiert die Entität als Medienlinkeintrag. Der Entitätszustand wird auch auf Modified festgelegt, damit der Datenstrom das nächste Mal an den Datendienst gesendet wird, der die SaveChanges-Methode aufgerufen wird.

Die SetSaveStream-Methode liest den Stream bis zum Ende. Ein Seek-Ablauf wird nicht für Stream versucht.

Wenn closeStream den Wert true hat, wird die SaveChanges-Methode den Datenstrom vor der Rückgabe schließen. Der Datenstrom wird geschlossen, selbst wenn ein Fehler auftritt, und der Datenstrom nicht gelesen wird.

Wenn entity über MediaEntryAttribute verfügt, kann die Medienressource kein Datenstrom sein. Entfernen Sie dieses Attribut, bevor Sie versuchen, den Datenstrom für entity festzulegen.

Keine Validierung wird auf den Headern ausgeführt, die in args festgelegt werden. Ändern Sie keinen HTTP-Header in einer Weise, die die Bedeutung von der Anforderung ändert.

Siehe auch

Verweis

DataServiceContext Klasse

SetSaveStream-Überladung

System.Data.Services.Client-Namespace