DataServiceContext.SetSaveStream メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
新しいデータ ストリームをエンティティのバイナリ プロパティとして設定します。
オーバーロード
| 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 -> unitPublic Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)パラメーター
- entity
- Object
データ ストリームを割り当てるバイナリ プロパティを含むエンティティ。
- closeStream
- Boolean
Boolean メソッドの完了時にデータ ストリームを閉じるかどうかを決定する SaveChanges() 値。
HTTP 要求メッセージの設定が含まれている DataServiceRequestArgs クラスのインスタンス。
例外
このメソッドに指定されたパラメーターのいずれかが null です。
注釈
メソッドは 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 -> unitPublic Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)パラメーター
- entity
- Object
データ ストリームを割り当てるバイナリ プロパティを含むエンティティ。
- closeStream
- Boolean
Boolean メソッドの完了時にデータ ストリームを閉じるかどうかを決定する SaveChanges() 値。
- contentType
- String
要求メッセージの Content-Type ヘッダー値。
- slug
- String
要求メッセージの Slug ヘッダー値。
例外
このメソッドに指定されたパラメーターのいずれかが null です。
注釈
メソッドは SetSaveStream 、メディア リンク エントリと呼ばれる に関連付 entityけられているメディア リソースであるバイナリ ストリームを設定します。
SetSaveStream メソッドを呼び出すと、エンティティがメディア リンク エントリとしてマークされます。 次に Modified メソッドが呼び出されたときにストリームがデータ サービスに送信されるように、エンティティの状態も SaveChanges に設定されます。
SetSaveStream メソッドは Stream を最後まで読み取ります。 Seek 操作は Stream では試行されません。
が のtrue場合closeStream、メソッドはSaveChangesストリームを閉じてからストリームを返します。 エラーが発生し、ストリームが読み取られなかった場合も、このストリームは閉じられます。
entity に MediaEntryAttribute が適用されている場合、メディア リソースをデータ ストリームにすることはできません。 entity のデータ ストリームを設定する前に、この属性を削除してください。
contentType と slug で設定されているヘッダーの検証は実行されません。 そのため、要求の意味を変更する方法でこれらの HTTP ヘッダーを変更しないでください。
適用対象
.NET