DataServiceContext.AddObject(String, Object) メソッド

定義

名前空間:

System.Data.Services.Client

アセンブリ:

System.Data.Services.Client.dll

DataServiceContext が追跡しているオブジェクトのセットに、指定されたオブジェクトを追加します。

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

public void AddObject (string entitySetName, object entity);

member this.AddObject : string * obj -> unit

Public Sub AddObject (entitySetName As String, entity As Object)

パラメーター

entitySetName

String

リソースが追加されるエンティティ セットの名前。

entity

Object

DataServiceContext によって追跡されるオブジェクト。

例外

ArgumentNullException

entitySetName または entity が null です。

ArgumentException

entitySetName が空です。

- または -

entity にはキー プロパティが定義されていません。

InvalidOperationException

エンティティはコンテキストによって既に追跡されています。

注釈

オブジェクトは、DataServiceContext 状態で、Added の追跡セットに追加されます。 DataServiceContext は、次に SaveChanges を呼び出したときに HTTP POST によってオブジェクトを挿入しようとします。 このメソッドは、指定されたエンティティに関連するオブジェクトを DataServiceContext に追加しません。 各オブジェクトは、AddObject の別個の呼び出しで追加する必要があります。

メソッドは、指定されたエンティティ セットが に関連付 DataServiceContext けられているデータ サービス内にあるか、追加されたオブジェクトに、指定した entity setに追加する必要がある必要なプロパティを持っていることを検証しません。