Freigeben über


DataServiceContext.SetSaveStream Methode

Definition

Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest.

Überlädt

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Legt einen neuen Datenstrom mit den angegebenen Einstellungen in der Anforderungsnachricht als die binäre Eigenschaft einer Entität fest.

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

Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest. Die angegebenen Content-Type- und Slug-Header sind in der Anforderungsnachricht enthalten.

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Legt einen neuen Datenstrom mit den angegebenen Einstellungen in der Anforderungsnachricht als die binäre Eigenschaft einer Entität fest.

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)

Parameter

entity
Object

Die Entität mit der binären Eigenschaft, der der Datenstrom zugewiesen werden soll.

stream
Stream

Der Stream, von dem die binären Daten gelesen werden sollen.

closeStream
Boolean

Ein Boolean-Wert, der bestimmt, ob der Datenstrom geschlossen wird, wenn die SaveChanges()-Methode abgeschlossen wird.

args
DataServiceRequestArgs

Instanz der Klasse DataServiceRequestArgs, die Einstellungen für die HTTP-Anforderungsnachricht enthält.

Ausnahmen

Einige der Parameter, die für die Methode angegeben wurden, sind null.

entity wird nicht von dieser DataServiceContext-Instanz nachverfolgt.

- oder -

entity verfügt über MediaEntryAttribute.

Hinweise

Die SetSaveStream -Methode legt den binären Datenstrom fest, bei dem es sich um die Medienressource handelt, die dem entityzugeordnet ist, was 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 ist true, schließt die SaveChanges -Methode den Stream, bevor er zurückgibt. 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.

Gilt für:

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

Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest. Die angegebenen Content-Type- und Slug-Header sind in der Anforderungsnachricht enthalten.

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)

Parameter

entity
Object

Die Entität mit der binären Eigenschaft, der der Datenstrom zugewiesen werden soll.

stream
Stream

Der Stream, von dem die binären Daten gelesen werden sollen.

closeStream
Boolean

Ein Boolean-Wert, der bestimmt, ob der Datenstrom geschlossen wird, wenn die SaveChanges()-Methode abgeschlossen wird.

contentType
String

Der Content-Type-Headerwert für die Anforderungsnachricht.

slug
String

Der Slug-Header-Wert für die Anforderungsnachricht.

Ausnahmen

Einige der Parameter, die für die Methode angegeben wurden, sind null.

entity wird nicht von dieser DataServiceContext-Instanz nachverfolgt.

- oder -

entity verfügt über MediaEntryAttribute.

Hinweise

Die SetSaveStream -Methode legt den binären Datenstrom fest, bei dem es sich um die Medienressource handelt, die dem entityzugeordnet ist, was 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 ist true, schließt die SaveChanges -Methode den Stream, bevor er zurückgibt. 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 contentType und slug festgelegt werden. Ändern Sie diese HTTP-Header nicht in einer Weise, die die Bedeutung von der Anforderung ändert.

Gilt für: