Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt den Datenstrom zurück, mit dem der Datendienst die vom Client als benannter Datenstrom erhaltenen Binärdaten schreibt.
Namespace: System.Data.Services.Providers
Assembly: Microsoft.Data.Services (in Microsoft.Data.Services.dll)
Syntax
'Declaration
Function GetWriteStream ( _
entity As Object, _
streamProperty As ResourceProperty, _
etag As String, _
checkETagForEquality As Nullable(Of Boolean), _
operationContext As DataServiceOperationContext _
) As Stream
'Usage
Dim instance As IDataServiceStreamProvider2
Dim entity As Object
Dim streamProperty As ResourceProperty
Dim etag As String
Dim checkETagForEquality As Nullable(Of Boolean)
Dim operationContext As DataServiceOperationContext
Dim returnValue As Stream
returnValue = instance.GetWriteStream(entity, _
streamProperty, etag, checkETagForEquality, _
operationContext)
Stream GetWriteStream(
Object entity,
ResourceProperty streamProperty,
string etag,
Nullable<bool> checkETagForEquality,
DataServiceOperationContext operationContext
)
Stream^ GetWriteStream(
Object^ entity,
ResourceProperty^ streamProperty,
String^ etag,
Nullable<bool> checkETagForEquality,
DataServiceOperationContext^ operationContext
)
abstract GetWriteStream :
entity:Object *
streamProperty:ResourceProperty *
etag:string *
checkETagForEquality:Nullable<bool> *
operationContext:DataServiceOperationContext -> Stream
function GetWriteStream(
entity : Object,
streamProperty : ResourceProperty,
etag : String,
checkETagForEquality : Nullable<boolean>,
operationContext : DataServiceOperationContext
) : Stream
Parameter
- entity
Typ: System.Object
Die Entität, zu der der benannte Datenstrom gehört.
- streamProperty
Typ: System.Data.Services.Providers.ResourceProperty
Ein ResourceProperty-Objekt, das den benannten Datenstrom darstellt.
- etag
Typ: System.String
Der als Teil der HTTP-Anforderung an den Datendienst gesendete eTag-Wert.
- checkETagForEquality
Typ: System.Nullable<Boolean>
Ein auf NULL festlegbarer Boolean-Wert, der bestimmt, welche bedingte Anforderung zum Datendienst ausgegeben wurde. Dieser Wert lautet true, wenn das eTag in einem If-Match-Header gesendet wurde, false, wenn das eTag in einem If-None-Match-Header gesendet wurde und nullein NULL-Verweis (Nothing in Visual Basic), wenn die Anforderung nicht bedingt war und kein eTag in der Anforderung enthalten war.
- operationContext
Typ: System.Data.Services.DataServiceOperationContext
Die vom Datendienst verwendete DataServiceOperationContext-Instanz zur Verarbeitung der Anforderung.
Rückgabewert
Typ: System.IO.Stream
Ein gültiger Stream, mit dem der Datendienst den Inhalt vom Client empfangener Binärdaten schreibt.
Hinweise
Die GetWriteStream-Methode sollte nie einen NULL-Wert zurückgeben.
Der operationContext wird als Argument angegeben, da eine Implementierung dieser Schnittstellenmethode Informationen von den zu erstellenden HTTP-Anforderungs-Headern 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, sollte diese Methode den angeforderten Datenstrom zurückgeben. Wenn die Parallelitätsüberprüfungen fehlschlägt, sollte die Methode einen DataServiceException mit dem entsprechenden HTTP-Antwortcode auslösen.
Wenn Sie diese Methode implementieren, müssen Sie die Content-Type- oder eTag-HTTP-Antwortheader nicht festlegen, da sie von der Datendienstlaufzeit festgelegt werden. Sie legen möglicherweise die verbleibenden HTTP-Antwortheader mit dem angegebenen operationContext fest.