DataServiceContext.GetReadStream 方法

定义

命名空间:

System.Data.Services.Client

程序集:

System.Data.Services.Client.dll

获取数据流形式的指定实体的二进制属性数据。

重载

GetReadStream(Object)	获取数据流形式的指定实体的二进制属性数据。
GetReadStream(Object, DataServiceRequestArgs)	获取数据流形式的指定实体的二进制属性数据以及指定的消息标头。
GetReadStream(Object, String)	获取数据流形式的指定实体的二进制属性数据以及指定的 Accept 消息标头。

GetReadStream(Object)

获取数据流形式的指定实体的二进制属性数据。

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity);

member this.GetReadStream : obj -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object) As DataServiceStreamResponse

参数

entity

Object

具有要检索的二进制属性的实体。

返回

DataServiceStreamResponse

表示响应的 DataServiceStreamResponse 实例。

例外

ArgumentNullException

entity 为 null。

ArgumentException

entity 不是由此 DataServiceContext 进行跟踪。

- 或 -

entity 处于 Added 状态。

- 或 -

entity 不是媒体链接项，且不具有二进制属性。

注解

方法 GetReadStream 同步请求包含所请求 entity的二进制属性的数据流。

在 AtomPub 协议中， entity 是媒体链接条目， 二进制属性是关联的媒体资源。

GetReadStream(Object, DataServiceRequestArgs)

获取数据流形式的指定实体的二进制属性数据以及指定的消息标头。

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args);

member this.GetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, args As DataServiceRequestArgs) As DataServiceStreamResponse

参数

entity

Object

具有要检索的二进制属性的实体。

args

DataServiceRequestArgs

包含 HTTP 请求消息设置的 DataServiceRequestArgs 类的实例。

返回

DataServiceStreamResponse

表示响应的 DataServiceStreamResponse 实例。

例外

ArgumentNullException

entity 为 null。

或

args 为 null。

ArgumentException

entity 不是由此 DataServiceContext 进行跟踪。

- 或 -

entity 处于 Added 状态。

- 或 -

entity 不是媒体链接项，且不具有二进制属性。

注解

方法 GetReadStream 同步请求包含所请求 entity的二进制属性的数据流。

在 AtomPub 协议中， entity 是媒体链接条目， 二进制属性是关联的媒体资源。

未对 args 中设置的标头进行任何验证。 因此，请不要以更改请求含义的方式来更改 HTTP 标头。

GetReadStream(Object, String)

获取数据流形式的指定实体的二进制属性数据以及指定的 Accept 消息标头。

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::String ^ acceptContentType);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity, string acceptContentType);

member this.GetReadStream : obj * string -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, acceptContentType As String) As DataServiceStreamResponse

参数

entity

Object

具有要检索的二进制属性的实体。

acceptContentType

String

从数据服务中请求的数据的内容类型，此类型在 Accept 标头中指定。

返回

DataServiceStreamResponse

表示响应的 DataServiceStreamResponse 实例。

例外

ArgumentNullException

entity 为 null。

或

acceptContentType 为 null。

ArgumentException

entity 不是由此 DataServiceContext 进行跟踪。

- 或 -

entity 处于 Added 状态。

- 或 -

entity 不是媒体链接项，且不具有二进制属性。

注解

参数 acceptContentType 应为 Accept HTTP 标头的有效值。

方法 GetReadStream 同步请求包含所请求 entity的二进制属性的数据流。

在 AtomPub 协议中， entity 是媒体链接条目， 二进制属性是关联的媒体资源。

未对 acceptContentType 中设置的标头进行任何验证。 因此，请不要以更改请求含义的方式来更改该 HTTP 标头。