IDataServiceStreamProvider.GetReadStream メソッド

定義

メディア リンク エントリである指定されたエンティティのメディア リソース データを格納するストリームを返します。

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>

使用される eTag の種類を決定する null 許容の Boolean 値。

operationContext
DataServiceOperationContext

要求を処理するためにデータ サービスによって使用される DataServiceOperationContext インスタンス。

戻り値

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 (メディア リンク エントリ) のメディア リソースを要求したときに、データ サービスがクライアントに返すストリームを取得するために、データ サービス ランタイムによって呼び出されます。 詳細については、「ストリーミング プロバイダー」を参照してください。

適用対象