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
DataServiceRequestArgs 類別的執行個體，其中包含 HTTP 要求訊息的設定。
傳回值
型別：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 標頭。