IDataServiceStreamProvider2.GetReadStream 方法 (Object, ResourceProperty, String, Nullable<Boolean>, DataServiceOperationContext)

傳回包含具名資料流之二進位資料的資料流。

命名空間：  System.Data.Services.Providers
組件：  Microsoft.Data.Services (在 Microsoft.Data.Services.dll 中)

語法

'宣告
Function GetReadStream ( _
    entity As Object, _
    streamProperty As ResourceProperty, _
    etag As String, _
    checkETagForEquality As Nullable(Of Boolean), _
    operationContext As DataServiceOperationContext _
) As Stream
'用途
Dim instance As IDataServiceStreamProvider2
Dim entity As Object
Dim streamProperty As ResourceProperty
Dim etag As String
Dim checkETagForEquality As Nullable(Of Boolean)
Dim operationContext As DataServiceOperationContext
Dim returnValue As Stream

returnValue = instance.GetReadStream(entity, _
    streamProperty, etag, checkETagForEquality, _
    operationContext)

Stream GetReadStream(
    Object entity,
    ResourceProperty streamProperty,
    string etag,
    Nullable<bool> checkETagForEquality,
    DataServiceOperationContext operationContext
)

Stream^ GetReadStream(
    Object^ entity, 
    ResourceProperty^ streamProperty, 
    String^ etag, 
    Nullable<bool> checkETagForEquality, 
    DataServiceOperationContext^ operationContext
)

abstract GetReadStream : 
        entity:Object * 
        streamProperty:ResourceProperty * 
        etag:string * 
        checkETagForEquality:Nullable<bool> * 
        operationContext:DataServiceOperationContext -> Stream 

function GetReadStream(
    entity : Object, 
    streamProperty : ResourceProperty, 
    etag : String, 
    checkETagForEquality : Nullable<boolean>, 
    operationContext : DataServiceOperationContext
) : Stream

參數

• entity
  型別：System.Object
  具名資料流所屬的實體。

• streamProperty
  型別：System.Data.Services.Providers.ResourceProperty
  表示具名資料流的 ResourceProperty 物件。

• etag
  型別：System.String
  當做 HTTP 要求的一部分傳送至資料服務的 eTag 值。

• checkETagForEquality
  型別：System.Nullable<Boolean>
  可為 null 的 Boolean 值，這個值會判斷向資料服務發出的條件式要求種類，以 If-Match 標頭傳送 eTag 時為 true；以 If-None-Match 標頭傳送 eTag 時為 false；非條件式要求且要求中不包含任何 eTag 時則為 nullnull 參考 (在 Visual Basic 中為 Nothing)。

• operationContext
  型別：System.Data.Services.DataServiceOperationContext
  資料服務用來處理要求的 DataServiceOperationContext 執行個體。

傳回值

型別：System.IO.Stream

備註

eTag 是 If-Match 或 If-None-Match 標頭的值。

GetReadStream 方法是透過資料服務執行階段呼叫，用於取得二進位資料流，當用戶端要求指定之 entity 的具名資料流時，資料服務會將該二進位資料流傳回至用戶端。 當用戶端要求屬於「媒體連結項目」(Media Link Entry) 之實體的「媒體資源」(Media Resource) 時，會改用 GetReadStream 方法。 如需詳細資訊，請參閱資料流處理提供者 (WCF Data Services)。

請參閱

參考

IDataServiceStreamProvider2 介面

GetReadStream 多載

System.Data.Services.Providers 命名空間