DataServiceContext.SetSaveStream メソッド

定義

名前空間:

System.Data.Services.Client

アセンブリ:

System.Data.Services.Client.dll

新しいデータ ストリームをエンティティのバイナリ プロパティとして設定します。

オーバーロード

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	要求メッセージの設定を指定して、新しいデータ ストリームをエンティティのバイナリ プロパティとして設定します。
SetSaveStream(Object, Stream, Boolean, String, String)	新しいデータ ストリームをエンティティのバイナリ プロパティとして設定します。 指定した Content-Type ヘッダーと Slug ヘッダーが要求メッセージに含まれます。

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

要求メッセージの設定を指定して、新しいデータ ストリームをエンティティのバイナリ プロパティとして設定します。

public:
 void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::Data::Services::Client::DataServiceRequestArgs ^ args);

public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, System.Data.Services.Client.DataServiceRequestArgs args);

member this.SetSaveStream : obj * System.IO.Stream * bool * System.Data.Services.Client.DataServiceRequestArgs -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)

パラメーター

entity

Object

データ ストリームを割り当てるバイナリ プロパティを含むエンティティ。

stream

Stream

バイナリ データの読み取り元である Stream。

closeStream

Boolean

Boolean メソッドの完了時にデータ ストリームを閉じるかどうかを決定する SaveChanges() 値。

args

DataServiceRequestArgs

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

例外

ArgumentNullException

このメソッドに指定されたパラメーターのいずれかが null です。

ArgumentException

entity はこの DataServiceContext インスタンスによって追跡されていません。

- または -

entity に MediaEntryAttribute が適用されています。

注釈

メソッドは SetSaveStream 、メディア リンク エントリと呼ばれる に関連付 entityけられているメディア リソースであるバイナリ ストリームを設定します。

SetSaveStream メソッドを呼び出すと、エンティティがメディア リンク エントリとしてマークされます。 次に Modified メソッドが呼び出されたときにストリームがデータ サービスに送信されるように、エンティティの状態も SaveChanges に設定されます。

SetSaveStream メソッドは Stream を最後まで読み取ります。 Seek 操作は Stream では試行されません。

が のtrue場合closeStream、メソッドはSaveChangesストリームを閉じてからストリームを返します。 エラーが発生し、ストリームが読み取られなかった場合も、このストリームは閉じられます。

entity に MediaEntryAttribute が適用されている場合、メディア リソースをデータ ストリームにすることはできません。 entity のデータ ストリームを設定する前に、この属性を削除してください。

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

SetSaveStream(Object, Stream, Boolean, String, String)

新しいデータ ストリームをエンティティのバイナリ プロパティとして設定します。 指定した Content-Type ヘッダーと Slug ヘッダーが要求メッセージに含まれます。

public:
 void SetSaveStream(System::Object ^ entity, System::IO::Stream ^ stream, bool closeStream, System::String ^ contentType, System::String ^ slug);

public void SetSaveStream (object entity, System.IO.Stream stream, bool closeStream, string contentType, string slug);

member this.SetSaveStream : obj * System.IO.Stream * bool * string * string -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)

パラメーター

entity

Object

データ ストリームを割り当てるバイナリ プロパティを含むエンティティ。

stream

Stream

バイナリ データの読み取り元である Stream。

closeStream

Boolean

Boolean メソッドの完了時にデータ ストリームを閉じるかどうかを決定する SaveChanges() 値。

contentType

String

要求メッセージの Content-Type ヘッダー値。

slug

String

要求メッセージの Slug ヘッダー値。

例外

ArgumentNullException

このメソッドに指定されたパラメーターのいずれかが null です。

ArgumentException

entity はこの DataServiceContext インスタンスによって追跡されていません。

- または -

entity に MediaEntryAttribute が適用されています。

注釈

メソッドは SetSaveStream 、メディア リンク エントリと呼ばれる に関連付 entityけられているメディア リソースであるバイナリ ストリームを設定します。

SetSaveStream メソッドを呼び出すと、エンティティがメディア リンク エントリとしてマークされます。 次に Modified メソッドが呼び出されたときにストリームがデータ サービスに送信されるように、エンティティの状態も SaveChanges に設定されます。

SetSaveStream メソッドは Stream を最後まで読み取ります。 Seek 操作は Stream では試行されません。

が のtrue場合closeStream、メソッドはSaveChangesストリームを閉じてからストリームを返します。 エラーが発生し、ストリームが読み取られなかった場合も、このストリームは閉じられます。

entity に MediaEntryAttribute が適用されている場合、メディア リソースをデータ ストリームにすることはできません。 entity のデータ ストリームを設定する前に、この属性を削除してください。

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