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
包含要擷取之二進位資料流的實體。
- args
型別：System.Data.Services.Client.DataServiceRequestArgs
DataServiceRequestArgs 類別的執行個體，其中包含 HTTP 要求訊息的設定。
- 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 標頭。