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
名稱和實體容器名稱找不到實體集。
-或-
物件圖形中的任何物件都已經存在另一個狀態管理員中。
備註
在上呼叫 AttachTo ,將物件附加至對象內容中的特定實體集,或物件在Visual Basic中具有 null
(Nothing
值時 EntityKeyObjectContext) 。 如需詳細資訊,請參閱連結和中斷連結物件。
所附加的物件可以是單一物件或圖形的一部分。
格式的規則 entitySetName
如下所示:
DefaultContainerName如果 屬性為
null
,則必須entitySetName
在實體容器名稱<><中完整。實體集名稱>。DefaultContainerName如果 不是
null
,則entitySetName
可以是實體<容器名稱>。<實體集名稱>或<實體集名稱>。
所附加的物件不需要具有相關聯的 EntityKey。 如果對象沒有實體索引鍵,則 entitySetName
不能是空字串。
如果附加的物件具有 且 具有EntityKey值,則EntitySet實體索引鍵的 必須符合EntitySet根據 和 實體容器名稱找到的 entitySetName
。entitySetName