DataServiceContext.SetSaveStream 方法

定義

命名空間:

System.Data.Services.Client

組件:

System.Data.Services.Client.dll

將新資料流設定為實體的二進位屬性。

多載

SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	將新的資料流設定為實體的二進位屬性，包括要求訊息中所指定的設定。
SetSaveStream(Object, Stream, Boolean, String, String)	將新資料流設定為實體的二進位屬性。 指定的內容類型和 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 -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, args As DataServiceRequestArgs)

參數

entity

Object

實體，包含要在其中指派資料流的二進位屬性。

stream

Stream

要從中讀取二進位資料的 Stream。

closeStream

Boolean

Boolean 值，該值決定資料流在 SaveChanges() 方法完成時是否關閉。

args

DataServiceRequestArgs

DataServiceRequestArgs 類別的執行個體，其中包含 HTTP 要求訊息的設定。

例外狀況

ArgumentNullException

提供給方法的任何參數為 null。

ArgumentException

entity 未受到此 DataServiceContext 執行個體追蹤。

-或-

entity 已套用 MediaEntryAttribute。

備註

方法 SetSaveStream 會設定與相關聯的 entity媒體資源二進位數據流，這稱為媒體鏈接專案。

呼叫 SetSaveStream 方法會將實體標記為媒體連結項目。 實體狀態也設定為 Modified，因此下次呼叫 SaveChanges 方法時會將資料流傳送到資料服務。

SetSaveStream 方法會讀取 Stream 直到結尾。 Seek 上不會嘗試 Stream 作業。

當 為 true時closeStream，方法SaveChanges會在傳回之前關閉數據流。 即使發生錯誤而未讀取資料流，資料流也會關閉。

當 entity 已套用 MediaEntryAttribute 時，媒體資源不能是資料流。 先刪除此屬性，然後嘗試設定 entity 的資料流。

不會對 args 中設定的標頭執行任何驗證。 因此，請不要使用變更要求意義的方式變更 HTTP 標頭。

SetSaveStream(Object, Stream, Boolean, String, String)

將新資料流設定為實體的二進位屬性。 指定的內容類型和 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 -> unit

Public Sub SetSaveStream (entity As Object, stream As Stream, closeStream As Boolean, contentType As String, slug As String)

參數

entity

Object

實體，包含要在其中指派資料流的二進位屬性。

stream

Stream

要從中讀取二進位資料的 Stream。

closeStream

Boolean

Boolean 值，該值決定資料流在 SaveChanges() 方法完成時是否關閉。

contentType

String

要求訊息的 Content-Type 標頭值。

slug

String

要求訊息的 Slug 標頭值。

例外狀況

ArgumentNullException

提供給方法的任何參數為 null。

ArgumentException

entity 未受到此 DataServiceContext 執行個體追蹤。

-或-

entity 已套用 MediaEntryAttribute。

備註

方法 SetSaveStream 會設定與相關聯的 entity媒體資源二進位數據流，這稱為媒體鏈接專案。

呼叫 SetSaveStream 方法會將實體標記為媒體連結項目。 實體狀態也設定為 Modified，因此下次呼叫 SaveChanges 方法時會將資料流傳送到資料服務。

SetSaveStream 方法會讀取 Stream 直到結尾。 Seek 上不會嘗試 Stream 作業。

當 為 true時closeStream，方法SaveChanges會在傳回之前關閉數據流。 即使發生錯誤而未讀取資料流，資料流也會關閉。

當 entity 已套用 MediaEntryAttribute 時，媒體資源不能是資料流。 先刪除此屬性，然後嘗試設定 entity 的資料流。

不會對 contentType 和 slug 中設定的標頭執行任何驗證。 因此，請不要使用變更要求意義的方式變更這些 HTTP 標頭。