DataServiceContext.SetSaveStream 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將一個新的資料流設為實體的二進位屬性。
多載
| 名稱 | Description |
|---|---|
| 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。
當 closeStream 為 true時，該 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。
當 closeStream 為 true時，該 SaveChanges 方法會在串流返回前關閉該串流。 即使發生錯誤且串流未被讀取，串流仍會被關閉。
當 已經 entity 套用 時 MediaEntryAttribute ，媒體資源就不能成為資料串流。 在嘗試設定資料串流之前 entity，先移除這個屬性。
對於設定在 contentType 和 slug中的標頭，則未進行任何驗證。 因此，不要以改變請求意義的方式更改這些 HTTP 標頭。
