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

定義

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

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

例外

entitynull です。

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

  • または -

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

  • または -

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

  • または -

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

  • または -

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

  • または -

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

  • または -

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

  • または -

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

注釈

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

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

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

  • プロパティが DefaultContainerName .の場合はnullentitySetName.<Entity Set Name> のように完全修飾 <Entity Container Name> する必要があります。

  • DefaultContainerNameそうでないnull場合は、entitySetNameいずれか <Entity Container Name> を指定できます。<Entity Set Name> または <Entity Set Name>.

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

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

適用対象

こちらもご覧ください