ObjectContext.AttachTo(String, Object) メソッド

定義

名前空間:

System.Data.Objects

アセンブリ:

System.Data.Entity.dll

オブジェクトまたはオブジェクト グラフをオブジェクト コンテキストの特定のエンティティ セットにアタッチします。

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

アタッチする Object。

例外

ArgumentNullException

entity が null です。

InvalidOperationException

エンティティ セットが無効です。

- または -

オブジェクトのキーが一時キーです。

- または -

オブジェクトが EntityKey を持ち、EntitySet が、メソッドの引数として渡されたエンティティ セットと一致しません。

- または -

オブジェクトが EntityKey を持たず、エンティティ セットが指定されていません。

- または -

オブジェクト グラフのオブジェクトの EntityKey が一時キーです。

- または -

オブジェクト グラフのオブジェクトの EntityKey が無効です (キーの値がオブジェクトの値と一致しないなど)。

- または -

指定された entitySetName 名とエンティティ コンテナー名ではエンティティ セットが見つかりませんでした。

- または -

オブジェクト グラフのオブジェクトが別の状態マネージャーに既に存在します。

注釈

をObjectContext呼び出して、オブジェクトをオブジェクト コンテキスト内の特定のエンティティ セットにアタッチするか、オブジェクトに (Nothing Visual Basic では ) EntityKey 値があるnull場合は を呼び出AttachToします。 詳しくは、「オブジェクトのアタッチとデタッチ」をご覧ください。

アタッチされるオブジェクトには、単一のオブジェクトまたはグラフの一部を指定できます。

形式の entitySetName 規則は次のとおりです。

• プロパティが DefaultContainerName のentitySetName場合、 nullはエンティティ コンテナー名>のように<完全修飾する必要があります。<エンティティ セット名>。

• DefaultContainerNameが でないnullentitySetName場合、 にはエンティティ コンテナー名>のいずれかを<指定できます。<エンティティ セット名>または<エンティティ セット名>。

アタッチされるオブジェクトには、EntityKey が関連付けられている必要はありません。 オブジェクトにエンティティ キーがない場合は、 entitySetName 空の文字列にすることはできません。

アタッチEntityKeyされているオブジェクトに と entitySetName の値がある場合、エンティティ キーの はEntitySet、 および エンティティ コンテナー名に基づいてentitySetName検出された と一致EntitySetする必要があります。

こちらもご覧ください

• Attach(TEntity)
• オブジェクトの使用 (Entity Framework)