DataServiceContext.SetSaveStream-Methode (Object, Stream, Boolean, String, String)
Legt einen binären Datenstrom fest, der zur angegebenen Entität gehört, mit dem angegebenen Content-Type und den Slug-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, _
contentType As String, _
slug As String _
)
'Usage
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
)
Parameter
- entity
Typ: System.Object
Die Entität, zu der der Datenstrom 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.
- contentType
Typ: System.String
Der Content-Type-Headerwert für die Anforderungsmeldung.
- slug
Typ: System.String
Der Slug-Header-Wert für die Anforderungsmeldung.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | Einer der zur Methode angegebenen Parameter ist nullein NULL-Verweis (Nothing in Visual Basic). |
ArgumentException | entity wird nicht von dieser DataServiceContext-Instanz nachverfolgt. - oder - Die Entität verfügt über MediaEntryAttribute. |
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 contentType und slug festgelegt werden. Ändern Sie diese HTTP-Header nicht in einer Weise, die die Bedeutung von der Anforderung ändert.