ObjectContext.AttachTo(String, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクトまたはオブジェクト グラフをオブジェクト コンテキストの特定のエンティティ セットにアタッチします。
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
が null
です。
エンティティ セットが無効です。
- または -
オブジェクトのキーが一時キーです。
- または -
オブジェクトが EntityKey を持ち、EntitySet が、メソッドの引数として渡されたエンティティ セットと一致しません。
- または -
オブジェクトが EntityKey を持たず、エンティティ セットが指定されていません。
- または -
オブジェクト グラフのオブジェクトの EntityKey が一時キーです。
- または -
オブジェクト グラフのオブジェクトの EntityKey が無効です (キーの値がオブジェクトの値と一致しないなど)。
- または -
指定された entitySetName
名とエンティティ コンテナー名ではエンティティ セットが見つかりませんでした。
- または -
オブジェクト グラフのオブジェクトが別の状態マネージャーに既に存在します。
注釈
オブジェクト コンテキストObjectContext内の特定のエンティティ セットにオブジェクトをアタッチする呼び出し、またはオブジェクトに (Nothing
Visual Basic) EntityKey 値がnull
含まれている場合に呼び出AttachToします。 詳しくは、「オブジェクトのアタッチとデタッチ」をご覧ください。
アタッチされるオブジェクトには、単一のオブジェクトまたはグラフの一部を指定できます。
形式の entitySetName
規則は次のとおりです。
プロパティが DefaultContainerName .の場合は
null
、entitySetName
.<Entity Set Name> のように完全修飾 <Entity Container Name> する必要があります。DefaultContainerNameそうでない
null
場合は、entitySetName
いずれか <Entity Container Name> を指定できます。<Entity Set Name> または <Entity Set Name>.
アタッチされるオブジェクトには、EntityKey が関連付けられている必要はありません。 オブジェクトにエンティティ キーがない場合は、 entitySetName
空の文字列にすることはできません。
アタッチEntityKeyされているオブジェクトに値がありentitySetName
、値がある場合は、EntitySetエンティティ キーの名前とエンティティ コンテナー名にEntitySetentitySetName
基づいて検出されたオブジェクトと一致する必要があります。