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

DataServiceRequestArgs 類別的執行個體，其中包含 HTTP 要求訊息的設定。

callback

AsyncCallback

有結果可供用戶端使用時要叫用的方法。

state

Object

傳遞至回呼的使用者定義狀態物件。

傳回

IAsyncResult

用於追蹤非同步作業之狀態的 IAsyncResult 物件。

例外狀況

ArgumentNullException

提供給方法的任何參數為 null。

ArgumentException

entity 未受到此 DataServiceContext 追蹤。

-或-

entity 處於 Added 狀態。

-或-

entity 並不是媒體連結項目，而且也沒有二進位屬性。

備註

方法 GetReadStream 會以異步方式要求包含所 entity要求 之二進位屬性的數據流。

在 AtomPub 通訊協定中， entity 是媒體鏈接專案，而二進位屬性是相關聯的媒體資源。

不會對 args 中設定的標頭執行任何驗證。 因此，請不要使用變更要求意義的方式變更 HTTP 標頭。