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 に関連付けられているデータ サービスに含まれているかどうかや、指定されたエンティティ セットに追加する必要がある必須プロパティが、追加されたオブジェクトに含まれているかどうかについては検証しません。