DataServiceContext.GetReadStream 方法 (Object, DataServiceRequestArgs)
通过使用指定消息头来获取指定实体的二进制数据流。
用于 Silverlight 的 WCF Data Services 5.0 客户端不支持。
命名空间: System.Data.Services.Client
程序集: Microsoft.Data.Services.Client(在 Microsoft.Data.Services.Client.dll 中)
语法
声明
Public Function GetReadStream ( _
entity As Object, _
args As DataServiceRequestArgs _
) As DataServiceStreamResponse
用法
Dim instance As DataServiceContext
Dim entity As Object
Dim args As DataServiceRequestArgs
Dim returnValue As DataServiceStreamResponse
returnValue = instance.GetReadStream(entity, _
args)
public DataServiceStreamResponse GetReadStream(
Object entity,
DataServiceRequestArgs args
)
public:
DataServiceStreamResponse^ GetReadStream(
Object^ entity,
DataServiceRequestArgs^ args
)
member GetReadStream :
entity:Object *
args:DataServiceRequestArgs -> DataServiceStreamResponse
public function GetReadStream(
entity : Object,
args : DataServiceRequestArgs
) : DataServiceStreamResponse
参数
- entity
类型:System.Object
具有要检索的二进制流的实体。
- args
类型:System.Data.Services.Client.DataServiceRequestArgs
包含 HTTP 请求消息设置的 DataServiceRequestArgs 类的实例。
返回值
类型:System.Data.Services.Client.DataServiceStreamResponse
表示响应的 DataServiceStreamResponse 实例。
异常
异常 | 条件 |
---|---|
ArgumentNullException | entity 为 nullnull 引用(在 Visual Basic 中为 Nothing)。 - 或 - args 为 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
ArgumentException | entity 不是由此 DataServiceContext 进行跟踪。 - 或 - entity 处于 Added 状态。 - 或 - entity 不是媒体链接入口,且没有相关的二进制流。 |
注释
GetReadStream 方法以同步方式请求二进制数据流(属于已请求的 entity)。
在 AtomPub 协议中,entity 为媒体链接入口,而流则为相关的媒体资源。
未对 args 中设置的标头进行任何验证。 因此,请不要以更改请求含义的方式来更改 HTTP 标头。