DataServiceContext.AddObject 方法

將指定的物件加入 DataServiceContext 正在追蹤的物件集。

命名空間：  System.Data.Services.Client
組件：  Microsoft.Data.Services.Client (在 Microsoft.Data.Services.Client.dll 中)

語法

'宣告
Public Sub AddObject ( _
    entitySetName As String, _
    entity As Object _
)
'用途
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object

instance.AddObject(entitySetName, entity)

public void AddObject(
    string entitySetName,
    Object entity
)

public:
void AddObject(
    String^ entitySetName, 
    Object^ entity
)

member AddObject : 
        entitySetName:string * 
        entity:Object -> unit 

public function AddObject(
    entitySetName : String, 
    entity : Object
)

參數

• entitySetName
  型別：System.String
  將加入資源的實體集名稱。

• entity
  型別：System.Object
  DataServiceContext 所要追蹤的物件。

例外狀況

例外狀況	條件
ArgumentNullException	當 entitySetName 或 entity 為 null 時。
ArgumentException	當 entitySetName 是空的。 -或- 當 entity 沒有定義的索引鍵屬性時。
InvalidOperationException	當實體已經受到內容追蹤時。

備註

物件是以 Added 狀態放入 DataServiceContext 的追蹤集。 DataServiceContext 會嘗試在下次呼叫 SaveChanges 時透過 HTTP POST 插入物件。 這個方法不會將與指定之實體相關的物件加入 DataServiceContext。 每個物件必須透過單獨呼叫 AddObject 來加入。

該方法不會驗證指定的實體集是否位於與 DataServiceContext 相關聯的資料服務中，或者加入的物件是否具有加入至指定之實體集所需的必要屬性。

請參閱

參考

DataServiceContext 類別

System.Data.Services.Client 命名空間