要求メッセージに指定された Content-Type および Slug ヘッダーを使用して、指定されたエンティティに属するバイナリ データ ストリームを設定します。
名前空間: System.Data.Services.Client
アセンブリ: Microsoft.Data.Services.Client (Microsoft.Data.Services.Client.dll)
構文
'宣言
Public Sub SetSaveStream ( _
entity As Object, _
stream As Stream, _
closeStream As Boolean, _
contentType As String, _
slug As String _
)
'使用
Dim instance As DataServiceContext
Dim entity As Object
Dim stream As Stream
Dim closeStream As Boolean
Dim contentType As String
Dim slug As String
instance.SetSaveStream(entity, stream, _
closeStream, contentType, slug)
public void SetSaveStream(
Object entity,
Stream stream,
bool closeStream,
string contentType,
string slug
)
public:
void SetSaveStream(
Object^ entity,
Stream^ stream,
bool closeStream,
String^ contentType,
String^ slug
)
member SetSaveStream :
entity:Object *
stream:Stream *
closeStream:bool *
contentType:string *
slug:string -> unit
public function SetSaveStream(
entity : Object,
stream : Stream,
closeStream : boolean,
contentType : String,
slug : String
)
パラメーター
- entity
型: System.Object
データ ストリームが属するエンティティ。
- stream
型: System.IO.Stream
バイナリ データの読み取り元である Stream。
- closeStream
型: System.Boolean
SaveChanges メソッドの完了時にデータ ストリームを閉じるかどうかを決定する Boolean 値。
- contentType
型: System.String
要求メッセージの Content-Type ヘッダー値。
- slug
型: System.String
要求メッセージの Slug ヘッダー値。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | メソッドに指定されたパラメーターのいずれかが nullNULL 参照 (Visual Basic では Nothing) です。 |
| ArgumentException | entity はこの DataServiceContext インスタンスによって追跡されていません。 または エンティティに MediaEntryAttribute が適用されています。 |
説明
SetSaveStream メソッドは、entity に属するメディア リソースであるバイナリ ストリームを設定します。これはメディア リンク エントリと呼ばれます。
SetSaveStream メソッドを呼び出すと、エンティティがメディア リンク エントリとしてマークされます。 次に SaveChanges メソッドが呼び出されたときにストリームがデータ サービスに送信されるように、エンティティの状態も Modified に設定されます。
SetSaveStream メソッドは Stream を最後まで読み取ります。 Seek 操作は Stream では試行されません。
closeStream が true の場合、SaveChanges メソッドは制御を返す前にストリームを閉じます。 エラーが発生し、ストリームが読み取られなかった場合も、このストリームは閉じられます。
entity に MediaEntryAttribute が適用されている場合、メディア リソースをデータ ストリームにすることはできません。 entity のデータ ストリームを設定する前に、この属性を削除してください。
contentType と slug で設定されているヘッダーの検証は実行されません。 そのため、要求の意味を変更する方法でこれらの HTTP ヘッダーを変更しないでください。