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