DataServiceContext.BeginGetReadStream メソッド

定義

名前空間:

System.Data.Services.Client

アセンブリ:

System.Data.Services.Client.dll

指定したエンティティのバイナリ プロパティ データを、指定したメッセージ ヘッダーと共にデータ ストリームとして非同期に取得します。

public:
 IAsyncResult ^ BeginGetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginGetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args, AsyncCallback callback, object state);

member this.BeginGetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs * AsyncCallback * obj -> IAsyncResult

Public Function BeginGetReadStream (entity As Object, args As DataServiceRequestArgs, callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

entity

Object

取得するバイナリ プロパティを含むエンティティ。

args

DataServiceRequestArgs

HTTP 要求メッセージの設定が含まれている DataServiceRequestArgs クラスのインスタンス。

callback

AsyncCallback

クライアントが結果を利用できるようになったときに呼び出すデリゲート。

state

Object

コールバックに渡されるユーザー定義の状態オブジェクト。

戻り値

IAsyncResult

非同期操作の状態を追跡するために使用される IAsyncResult オブジェクト。

例外

ArgumentNullException

このメソッドに指定されたパラメーターのいずれかが null です。

ArgumentException

entity はこの DataServiceContext によって追跡されません。

- または -

entity の状態が Added です。

- または -

entity は、メディア リンク エントリではなく、バイナリ プロパティがありません。

注釈

メソッドは GetReadStream 、要求された のバイナリ プロパティを含むデータ ストリームを非同期的に要求します entity。

AtomPub プロトコルでは、 entity はメディア リンク エントリであり、バイナリ プロパティは関連するメディア リソースです。

args で設定されているヘッダーの検証は実行されません。 そのため、要求の意味を変更する方法で HTTP ヘッダーを変更しないでください。