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 名稱和實體容器名稱找不到實體集。

-或-

物件圖形中的任何物件都已經存在另一個狀態管理員中。

備註

在上呼叫 AttachTo ，將物件附加至對象內容中的特定實體集，或如果物件在 Visual Basic 中具有 null (Nothing，則為) EntityKeyObjectContext 值。 如需詳細資訊，請參閱連結和中斷連結物件。

所附加的物件可以是單一物件或圖形的一部分。

格式的規則 entitySetName 如下所示：

  • DefaultContainerName如果屬性為 null，則必須entitySetName完整限定為實體容器名稱>中的<。<實體集名稱>。

  • DefaultContainerName如果 不是 null，則 entitySetName 可以是實體<容器名稱>。<實體集名稱>或<實體集名稱>。

所附加的物件不需要具有相關聯的 EntityKey。 如果對象沒有實體索引鍵，則 entitySetName 不能是空字串。

如果附加的物件具有 EntityKey 且 entitySetName 具有值，則 EntitySet 實體索引鍵的 必須符合 EntitySet 根據 和實體容器名稱找到的 entitySetName 。

適用於

另請參閱