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