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

包含 Stream 之二進位屬性資料的資料 entity。

備註

eTag 是 If-Match 或 If-None-Match 標頭的值。 支援下列值：

• true - 當 eTag 代表 If-Match 標頭時。

• false - 當 eTag 代表 If-None-Match 標頭時。

• null - 當要求中沒有 If-Match 或 If-None-Match 標頭時。

GetReadStream 方法是透過資料服務執行階段呼叫，用於取得資料流，當用戶端要求指定之 entity (媒體連結項目) 媒體資源時，資料服務會將該資料流傳回至用戶端。 如需詳細資訊，請參閱 串流提供者。