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
包含 HTTP 请求消息设置的 DataServiceRequestArgs 类的实例。
- 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 标头。