DataServiceContext.GetReadStream 方法 (Object, String)
通过使用指定的 Content-Type 消息头,获取属于指定实体的二进制数据流。
用于 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, _
acceptContentType As String _
) As DataServiceStreamResponse
用法
Dim instance As DataServiceContext
Dim entity As Object
Dim acceptContentType As String
Dim returnValue As DataServiceStreamResponse
returnValue = instance.GetReadStream(entity, _
acceptContentType)
public DataServiceStreamResponse GetReadStream(
Object entity,
string acceptContentType
)
public:
DataServiceStreamResponse^ GetReadStream(
Object^ entity,
String^ acceptContentType
)
member GetReadStream :
entity:Object *
acceptContentType:string -> DataServiceStreamResponse
public function GetReadStream(
entity : Object,
acceptContentType : String
) : DataServiceStreamResponse
参数
- entity
类型:System.Object
具有要检索的二进制数据流的实体。
- acceptContentType
类型:System.String
在 Accept 标头中指定的、从数据服务中请求的二进制数据流的内容类型。
返回值
类型:System.Data.Services.Client.DataServiceStreamResponse
表示响应的 DataServiceStreamResponse 实例。
异常
异常 | 条件 |
---|---|
ArgumentNullException | entity 为 nullnull 引用(在 Visual Basic 中为 Nothing)。 - 或 - acceptContentType 为 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
ArgumentException | entity 不是由此 DataServiceContext 进行跟踪。 - 或 - entity 处于 Added 状态。 - 或 - entity 不是媒体链接入口,且没有相关的流。 |
注释
acceptContentType 参数应为 Accept HTTP 标头的有效 Content-Type 值。
GetReadStream 方法以同步方式请求 entity 的相关二进制数据流。
在 AtomPub 协议中,entity 为媒体链接入口,而二进制流则为关联的媒体资源。
未对 acceptContentType 中设置的标头进行任何验证。 因此,请不要以更改请求含义的方式来更改该 HTTP 标头。