IDataServiceStreamProvider.GetReadStream 方法

定义

命名空间:

System.Data.Services.Providers

程序集:

System.Data.Services.dll

返回包含指定实体（即媒体链接项）的媒体资源数据的流。

public:
 System::IO::Stream ^ GetReadStream(System::Object ^ entity, System::String ^ etag, Nullable<bool> checkETagForEquality, System::Data::Services::DataServiceOperationContext ^ operationContext);

public System.IO.Stream GetReadStream (object entity, string etag, bool? checkETagForEquality, System.Data.Services.DataServiceOperationContext operationContext);

abstract member GetReadStream : obj * string * Nullable<bool> * System.Data.Services.DataServiceOperationContext -> System.IO.Stream

Public Function GetReadStream (entity As Object, etag As String, checkETagForEquality As Nullable(Of Boolean), operationContext As DataServiceOperationContext) As Stream

参数

entity

Object

作为具有相关媒体资源的媒体链接项的实体。

etag

String

作为发送到数据服务的 HTTP 请求的一部分发送的 eTag 值。

checkETagForEquality

Nullable<Boolean>

一个可以为 null 的 Boolean 值，该值确定数据服务是否必须为所使用的 eTag 类型。

operationContext

DataServiceOperationContext

数据服务用来处理请求的 DataServiceOperationContext 实例。

返回

Stream

包含 entity 的二进制属性数据的数据 Stream。

注解

eTag 是 If-Match 或 If-None-Match 标头的值。 支持以下值：

• true - 当 eTag 表示 If-Match 标头时。

• false - 当 eTag 表示 If-None-Match 标头时。

• null - 请求中不存在 If-Match 或 If-None-Match 标头时。

当客户端请求指定 GetReadStream（这是媒体链接项）的媒体资源时，数据服务方法运行时将调用 entity 方法以获取数据服务返回到客户端的流。 有关详细信息，请参阅 流式处理提供程序。