IDataServiceStreamProvider.GetWriteStream Methode

public:
 System::IO::Stream ^ GetWriteStream(System::Object ^ entity, System::String ^ etag, Nullable<bool> checkETagForEquality, System::Data::Services::DataServiceOperationContext ^ operationContext);

public System.IO.Stream GetWriteStream (object entity, string etag, bool? checkETagForEquality, System.Data.Services.DataServiceOperationContext operationContext);

abstract member GetWriteStream : obj * string * Nullable<bool> * System.Data.Services.DataServiceOperationContext -> System.IO.Stream

Public Function GetWriteStream (entity As Object, etag As String, checkETagForEquality As Nullable(Of Boolean), operationContext As DataServiceOperationContext) As Stream

Parameter

Gibt zurück

Ein gültiger Stream, mit dem der Datendienst den Inhalt vom Client empfangener Binärdaten schreibt.

Hinweise

Die GetWriteStream-Methode wird von der Datendienstlaufzeit aufgerufen, wenn ein Einfüge- oder Updatevorgang für die Medienressource verarbeitet wird, die der entity zugeordnet ist.

Die GetWriteStream -Methode sollte niemals einen null Wert zurückgeben.

Der operationContext wird als Argument angegeben, da eine Implementierung dieser Schnittstellenmethode Informationen von den HTTP-Anforderungsheadern benötigt, um einen Schreibdatenstrom zu erstellen. Wenn Sie diese Methode implementieren, müssen Sie ggf. Parallelitätsüberprüfungen ausführen. Wenn ein If-Match- oder If-None-Match-Anforderungsheader in der Anforderung enthalten war, ist der etag nicht null. In diesem Fall muss diese Methode die entsprechende Parallelitätsüberprüfung ausführen. Wenn die Parallelitätsüberprüfung bestanden wird, gibt diese Methode den angeforderten Datenstrom zurück. Wenn die Parallelitätsüberprüfungen fehlschlagen, löst die Methode eine DataServiceException mit dem entsprechenden HTTP-Antwortcode aus.

eTag ist der Wert eines If-Match- oder If-None-Match-Headers.

Die folgenden Werte von checkETagForEquality werden unterstützt:

• true – wenn das eTag einen If-Match-Header darstellt.

• false – wenn das eTag einen If-None-Match-Header darstellt.

• null – wenn in der Anforderung kein If-Match- oder If-None-Match-Header vorhanden ist.

Wenn Sie diese Methode implementieren, dürfen Sie nicht den Content-Type- oder eTag-HTTP-Antwortheader festlegen, da diese Header von der Datendienstlaufzeit festgelegt werden. Sie können die restlichen HTTP-Antwortheader mit dem bereitgestellten operationContext festlegen.

Wenn Sie diese Methode implementieren, sollten Sie nur die Eigenschaften für den operationContext festlegen, die für eine erfolgreiche Antwort erforderlich sind. Durch das Ändern anderer Eigenschaften von operationContext kann die Antwort des Datendiensts beschädigt werden.

Die Datendienstlaufzeit schließt den Datenstrom, wenn alle Bytes erfolgreich in den Datenstrom geschrieben wurden. Wenn beim Schreiben in den Datenstrom ein Fehler auftritt, generiert der Datendienst eine Fehlerantwort an den Client.

Wenn Sie die GetWriteStream-Methode implementieren, sollten die folgenden Ausnahmen entsprechend den angegebenen Bedingungen ausgelöst werden:

Gilt für: