DataServiceContext.SetSaveStream 方法 (Object, Stream, Boolean, DataServiceRequestArgs)
使用要求訊息中指定的標頭，設定指定之實體的二進位資料流。
命名空間： 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, _
args As DataServiceRequestArgs _
)
'用途
Dim instance As DataServiceContext
Dim entity As Object
Dim stream As Stream
Dim closeStream As Boolean
Dim args As DataServiceRequestArgs
instance.SetSaveStream(entity, stream, _
closeStream, args)
public void SetSaveStream(
Object entity,
Stream stream,
bool closeStream,
DataServiceRequestArgs args
)
public:
void SetSaveStream(
Object^ entity,
Stream^ stream,
bool closeStream,
DataServiceRequestArgs^ args
)
member SetSaveStream :
entity:Object *
stream:Stream *
closeStream:bool *
args:DataServiceRequestArgs -> unit
public function SetSaveStream(
entity : Object,
stream : Stream,
closeStream : boolean,
args : DataServiceRequestArgs
)
參數
- entity
型別：System.Object
二進位資料流所屬的實體。
- stream
型別：System.IO.Stream
要從中讀取二進位資料的 Stream。
- closeStream
型別：System.Boolean
Boolean 值，該值決定資料流在 SaveChanges 方法完成時是否關閉。
- args
型別：System.Data.Services.Client.DataServiceRequestArgs
DataServiceRequestArgs 類別的執行個體，其中包含 HTTP 要求訊息的設定。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | 提供給此方法的任何參數都是 nullnull 參考 (在 Visual Basic 中為 Nothing)。 |
| ArgumentException | entity 未受到此 DataServiceContext 執行個體追蹤。 -或- entity 已套用 MediaEntryAttribute。 |
備註
SetSaveStream 方法設定的二進位資料流是屬於 entity 的媒體資源，此實體稱為媒體連結項目。
呼叫 SetSaveStream 方法會將實體標記為媒體連結項目。 實體狀態也設定為 Modified，因此下次呼叫 SaveChanges 方法時會將資料流傳送到資料服務。
SetSaveStream 方法會讀取 Stream 直到結尾。 Stream 上不會嘗試 Seek 作業。
如果 closeStream 是 true，SaveChanges 方法會在傳回之前關閉資料流。 即使發生錯誤而未讀取資料流，資料流也會關閉。
當 entity 已套用 MediaEntryAttribute 時，媒體資源不能是資料流。 先刪除此屬性，然後嘗試設定 entity 的資料流。
不會對 args 中設定的標頭執行任何驗證。 因此，請不要使用變更要求意義的方式變更 HTTP 標頭。