IDataServiceStreamProvider2.GetWriteStream メソッド (Object, ResourceProperty, String, Nullable<Boolean>, DataServiceOperationContext)

  • [アーティクル]

指定された名前付きストリームとしてクライアントから受け取ったバイナリ データを書き込むためにデータ サービスで使用されるストリームを返します。

名前空間:  System.Data.Services.Providers
アセンブリ:  Microsoft.Data.Services (Microsoft.Data.Services.dll)

構文

'宣言
Function GetWriteStream ( _
    entity As Object, _
    streamProperty As ResourceProperty, _
    etag As String, _
    checkETagForEquality As Nullable(Of Boolean), _
    operationContext As DataServiceOperationContext _
) As Stream
'使用
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

パラメーター

  • entity
    型: System.Object
    名前付きストリームが属するエンティティ。
  • etag
    型: System.String
    データ サービスに送信される HTTP 要求の一部として送信される eTag 値。
  • checkETagForEquality
    型: System.Nullable<Boolean>
    データ サービスに発行された条件付き要求の種類を決定する null 許容の Boolean 値。eTag が If-Match ヘッダーで送信された場合は true。eTag が If-None-Match ヘッダーで送信された場合は false。要求が条件付きではなく、要求に eTag が含まれていなかった場合は nullNULL 参照 (Visual Basic では Nothing)。

戻り値

型: System.IO.Stream
クライアントから受け取ったバイナリ データの内容を書き込むためにデータ サービスで使用される有効な Stream。

説明

GetWriteStream メソッドが、nullNULL 参照 (Visual Basic では Nothing) 値を返すことはありません。

このインターフェイスのメソッドの実装側では、書き込みストリームを作成するのに HTTP 要求ヘッダーの情報を必要とするため、operationContext が引数として提供されます。 このメソッドを実装する場合は、必要に応じて、同時実行チェックを実行する必要があります。 要求内に If-Match または If-None-Match 要求ヘッダーが含まれていた場合、etag は nullNULL 参照 (Visual Basic では Nothing) にはなりません。 この場合、このメソッドでは適切な同時実行チェックを実行する必要があります。 同時実行チェックに合格した場合、このメソッドは要求されたストリームを返します。 同時実行チェックに失敗した場合、適切な HTTP 応答コードで DataServiceException が発生します。

このメソッドを実装する場合、Content-Type または eTag HTTP 応答ヘッダーはデータ サービス ランタイムによって設定されるため、それらを設定する必要はありません。 その他の HTTP 応答ヘッダーは、提供された operationContext を使用して設定できます。

関連項目

参照

IDataServiceStreamProvider2 インターフェイス

GetWriteStream オーバーロード

System.Data.Services.Providers 名前空間