DataServiceContext.AttachTo 方法

定義

命名空間:
System.Data.Services.Client
組件:
System.Data.Services.Client.dll

通知 開始 DataServiceContext 追蹤指定資源，並提供該資源在指定資源集中的位置。

多載

名稱 Description
AttachTo(String, Object)

通知 開始 DataServiceContext 追蹤指定資源，並提供該資源在指定資源集中的位置。
AttachTo(String, Object, String)

通知 開始 DataServiceContext 追蹤指定資源，並提供該資源在指定資源集中的位置。

AttachTo(String, Object)

通知 開始 DataServiceContext 追蹤指定資源，並提供該資源在指定資源集中的位置。

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity);
public void AttachTo(string entitySetName, object entity);
member this.AttachTo : string * obj -> unit
Public Sub AttachTo (entitySetName As String, entity As Object)

參數

entitySetName
String

包含該資源的集合名稱。

entity
Object

要被追蹤 DataServiceContext的資源。 該資源以未變更狀態附加。

例外狀況

ArgumentNullException

entity 或 entitySetName 為 null。

ArgumentException

entitySetName 是空字串。

-或-

entity 沒有定義關鍵性質。

InvalidOperationException

entity 已經被上下文追蹤了。

備註

若實體是物件圖的一部分，此操作不會遍歷圖以加入相關物件。 這是一個膚淺的操作。

此方法不會驗證指定的實體集合是否出現在與 DataServiceContext相關聯的資料服務中。

適用於

AttachTo(String, Object, String)

通知 開始 DataServiceContext 追蹤指定資源，並提供該資源在指定資源集中的位置。

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity, System::String ^ etag);
public void AttachTo(string entitySetName, object entity, string etag);
member this.AttachTo : string * obj * string -> unit
Public Sub AttachTo (entitySetName As String, entity As Object, etag As String)

參數

entitySetName
String

包含該實體所附加的實體名稱的字串值。

entity
Object

要加入的實體。

etag
String

etag 值代表該實體最後一次從資料服務取回時的狀態。 此值被視為不透明字串;用戶端函式庫不會對它進行驗證。

例外狀況

ArgumentNullException

entitySetName 是 null。

-或-

entity 是 null。

ArgumentException

entitySetName 是空字串。

-或-

所提供的物件沒有金鑰屬性。

InvalidOperationException

所提供的物件已經被上下文追蹤中。

備註

呼叫此方法會 DataServiceContext 通知 開始追蹤指定實體，並識別該實體所屬的實體集合。

若實體是物件圖的一部分，此操作不會遍歷圖以加入相關物件。 物件在未改變的狀態下加入 。DataServiceContext 此方法不會驗證指定的實體集合是否存在於與 DataServiceContext相關聯的資料服務中。

若使用帶有 etag 的超載，則指定的 etag 會與新附加的實體相關聯。 etag 隨後會被送往資料服務，並依據 HTTP 語意，對該實體進行所有後續更新或查詢操作。 不建議手動產生 etag 值，但此過載是為了讓可能已序列化並儲存的實體能與相關的並發元資料重新附加。

適用於