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

DataServiceRequestArgs 類別的執行個體，其中包含 HTTP 要求訊息的設定。

傳回

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 標頭。