次の方法で共有


DataServiceContext.BeginGetReadStream メソッド (Object, DataServiceRequestArgs, AsyncCallback, Object)

指定されたメッセージ ヘッダーを使用して、指定されたエンティティに属するバイナリ データ ストリームを非同期的に取得します。

名前空間:  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
    取得するバイナリ データ ストリームを持つエンティティ。
  • 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 ヘッダーを変更しないでください。

関連項目

参照

DataServiceContext クラス

BeginGetReadStream オーバーロード

System.Data.Services.Client 名前空間