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 标头。