指定されたメッセージ ヘッダーを使用して、指定されたエンティティのバイナリ データ ストリームを取得します。
Silverlight の WCF Data Services 5.0 クライアントではサポートされていません。
名前空間: System.Data.Services.Client
アセンブリ: Microsoft.Data.Services.Client (Microsoft.Data.Services.Client.dll)
構文
'宣言
Public Function GetReadStream ( _
entity As Object, _
args As DataServiceRequestArgs _
) As DataServiceStreamResponse
'使用
Dim instance As DataServiceContext
Dim entity As Object
Dim args As DataServiceRequestArgs
Dim returnValue As DataServiceStreamResponse
returnValue = instance.GetReadStream(entity, _
args)
public DataServiceStreamResponse GetReadStream(
Object entity,
DataServiceRequestArgs args
)
public:
DataServiceStreamResponse^ GetReadStream(
Object^ entity,
DataServiceRequestArgs^ args
)
member GetReadStream :
entity:Object *
args:DataServiceRequestArgs -> DataServiceStreamResponse
public function GetReadStream(
entity : Object,
args : DataServiceRequestArgs
) : DataServiceStreamResponse
パラメーター
- entity
型: System.Object
取得するバイナリ ストリームを持つエンティティ。
- args
型: System.Data.Services.Client.DataServiceRequestArgs
HTTP 要求メッセージの設定が含まれている DataServiceRequestArgs クラスのインスタンス。
戻り値
型: System.Data.Services.Client.DataServiceStreamResponse
応答を表す DataServiceStreamResponse のインスタンス。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | entity が nullNULL 参照 (Visual Basic では Nothing) です。 または args が nullNULL 参照 (Visual Basic では Nothing) です。 |
| ArgumentException | entity はこの DataServiceContext によって追跡されません。 または entity の状態が Added です。 または entity はメディア リンク エントリではなく、関連するバイナリ ストリームがありません。 |
説明
GetReadStream メソッドは、要求された entity に属しているバイナリ データ ストリームを同期的に要求します。
AtomPub プロトコルでは、entity はメディア リンク エントリで、ストリームは関連付けられたメディア リソースです。
args で設定されているヘッダーの検証は実行されません。 そのため、要求の意味を変更する方法で HTTP ヘッダーを変更しないでください。