DataServiceContext.SetSaveStream メソッド

定義

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

オーバーロード

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 クラスのインスタンス。

例外

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

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

- または -

entityMediaEntryAttribute が適用されています。

注釈

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

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

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

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

entityMediaEntryAttribute が適用されている場合、メディア リソースをデータ ストリームにすることはできません。 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 ヘッダー値。

例外

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

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

- または -

entityMediaEntryAttribute が適用されています。

注釈

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

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

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

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

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

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

適用対象