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
從資料服務要求之二進位資料流的 Content-Type，在 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 標頭。