DataServiceContext.GetReadStream メソッド

定義

名前空間:

System.Data.Services.Client

アセンブリ:

System.Data.Services.Client.dll

指定したエンティティのバイナリ プロパティ データをデータ ストリームとして取得します。

オーバーロード

GetReadStream(Object)	指定したエンティティのバイナリ プロパティ データをデータ ストリームとして取得します。
GetReadStream(Object, DataServiceRequestArgs)	指定したエンティティのバイナリ プロパティ データを、指定したメッセージ ヘッダーと共にデータ ストリームとして取得します。
GetReadStream(Object, String)	Accept メッセージ ヘッダーを指定して、指定したエンティティのバイナリ プロパティ データをデータ ストリームとして取得します。

GetReadStream(Object)

指定したエンティティのバイナリ プロパティ データをデータ ストリームとして取得します。

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity);

member this.GetReadStream : obj -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object) As DataServiceStreamResponse

パラメーター

entity

Object

取得するバイナリ プロパティを含むエンティティ。

戻り値

DataServiceStreamResponse

応答を表す DataServiceStreamResponse のインスタンス。

例外

ArgumentNullException

entity が null です。

ArgumentException

entity はこの DataServiceContext によって追跡されません。

- または -

entity の状態が Added です。

- または -

entity は、メディア リンク エントリではなく、バイナリ プロパティがありません。

注釈

メソッドは GetReadStream 、要求された のバイナリ プロパティを含むデータ ストリームを同期的に要求します entity。

AtomPub プロトコルでは、 entity はメディア リンク エントリであり、バイナリ プロパティは関連するメディア リソースです。

GetReadStream(Object, DataServiceRequestArgs)

指定したエンティティのバイナリ プロパティ データを、指定したメッセージ ヘッダーと共にデータ ストリームとして取得します。

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::Data::Services::Client::DataServiceRequestArgs ^ args);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity, System.Data.Services.Client.DataServiceRequestArgs args);

member this.GetReadStream : obj * System.Data.Services.Client.DataServiceRequestArgs -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, args As DataServiceRequestArgs) As DataServiceStreamResponse

パラメーター

entity

Object

取得するバイナリ プロパティを含むエンティティ。

args

DataServiceRequestArgs

HTTP 要求メッセージの設定が含まれている DataServiceRequestArgs クラスのインスタンス。

戻り値

DataServiceStreamResponse

応答を表す DataServiceStreamResponse のインスタンス。

例外

ArgumentNullException

entity は null です。

または

args が nullです。

ArgumentException

entity はこの DataServiceContext によって追跡されません。

- または -

entity の状態が Added です。

- または -

entity は、メディア リンク エントリではなく、バイナリ プロパティがありません。

注釈

メソッドは GetReadStream 、要求された のバイナリ プロパティを含むデータ ストリームを同期的に要求します entity。

AtomPub プロトコルでは、 entity はメディア リンク エントリであり、バイナリ プロパティは関連するメディア リソースです。

args で設定されているヘッダーの検証は実行されません。 そのため、要求の意味を変更する方法で HTTP ヘッダーを変更しないでください。

GetReadStream(Object, String)

Accept メッセージ ヘッダーを指定して、指定したエンティティのバイナリ プロパティ データをデータ ストリームとして取得します。

public:
 System::Data::Services::Client::DataServiceStreamResponse ^ GetReadStream(System::Object ^ entity, System::String ^ acceptContentType);

public System.Data.Services.Client.DataServiceStreamResponse GetReadStream (object entity, string acceptContentType);

member this.GetReadStream : obj * string -> System.Data.Services.Client.DataServiceStreamResponse

Public Function GetReadStream (entity As Object, acceptContentType As String) As DataServiceStreamResponse

パラメーター

entity

Object

取得するバイナリ プロパティを含むエンティティ。

acceptContentType

String

データ サービスから要求されるデータのコンテンツ タイプ (Accept ヘッダーで指定)。

戻り値

DataServiceStreamResponse

応答を表す DataServiceStreamResponse のインスタンス。

例外

ArgumentNullException

entity は null です。

または

acceptContentType が nullです。

ArgumentException

entity はこの DataServiceContext によって追跡されません。

- または -

entity の状態が Added です。

- または -

entity は、メディア リンク エントリではなく、バイナリ プロパティがありません。

注釈

パラメーターは acceptContentType Accept HTTP ヘッダーの有効な値である必要があります。

メソッドは GetReadStream 、要求された のバイナリ プロパティを含むデータ ストリームを同期的に要求します entity。

AtomPub プロトコルでは、 entity はメディア リンク エントリであり、バイナリ プロパティは関連するメディア リソースです。

acceptContentType で設定されているヘッダーの検証は実行されません。 そのため、要求の意味を変更する方法でこの HTTP ヘッダーを変更しないでください。