DataServiceContext.SetSaveStream Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
- closeStream
- Boolean
Ein Boolean-Wert, der bestimmt, ob der Datenstrom geschlossen wird, wenn die SaveChanges()-Methode abgeschlossen wird.
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 entity
zugeordnet 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.
- 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 entity
zugeordnet 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.