DataServiceContext.SetSaveStream 方法 (Object, Stream, Boolean, String, String)
透過使用要求訊息中指定的 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
Boolean 值，該值決定資料流在 SaveChanges 方法完成時是否關閉。
- contentType
型別：System.String
要求訊息的 Content-Type 標頭值。
- slug
型別：System.String
要求訊息的 Slug 標頭值。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| 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 的資料流。
不會對 contentType 和 slug 中設定的標頭執行任何驗證。 因此，請不要使用變更要求意義的方式變更這些 HTTP 標頭。