Term.Merge 方法
合併與指定Term目前的Term物件，並傳回合併的Term。
命名空間: Microsoft.SharePoint.Client.Taxonomy
組件： Microsoft.SharePoint.Client.Taxonomy.Silverlight (在 Microsoft.SharePoint.Client.Taxonomy.Silverlight.dll 中); Microsoft.SharePoint.Client.Taxonomy.Phone (在 Microsoft.SharePoint.Client.Taxonomy.Phone.dll 中) Microsoft.SharePoint.Client.Taxonomy (在 Microsoft.SharePoint.Client.Taxonomy.dll 中)
語法
'宣告
Public Function Merge ( _
termToMerge As Term _
) As Term
'用途
Dim instance As Term
Dim termToMerge As Term
Dim returnValue As Term
returnValue = instance.Merge(termToMerge)
public Term Merge(
Term termToMerge
)
參數
termToMerge
類型：Microsoft.SharePoint.Client.Taxonomy.Term目前Term
傳回值
類型：Microsoft.SharePoint.Client.Taxonomy.Term
合併的Term
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | 若要合併成Term是null 參考 (未執行任何動作 於 Visual Basic 中)。 |
| ArgumentException | 若要合併成Term不正確。 |
| TermStoreOperationException | 這項作業中不正確的孤立的字詞TermSet物件。作業失敗。 |
| TermStoreOperationException | 無法合併至其中重複使用的TermTerm 。 |
| TermStoreOperationException | 僅限來源Term可以合併到另一個來源Term。 |
| TermStoreOperationException | 不允許合併兩個指定的Term物件。來源Term目標Term的合併列印中相同的TermSet物件，重複使用，並才能 mergeable 必須在該TermSet同層級。 |
| UnauthorizedAccessException | 目前的使用者會有足夠的權限，才能執行此作業。 |
備註
目前TermTerm合併，而termToMerge會合併到 (目標Term) Term 。Merge() 作業完成後，這兩個Term物件成為重複使用，以及targetTerm變成中重複使用的Term物件的來源。目標TermGUID會變成的合併TermGUID。目前Term GUID 會新增至MergedTermIds
目標Term GUID更新Term GUID目前Term或任何其中重複使用的複本的父系自訂排序順序。
自訂排序順序會以下列方式合併 ︰ 如果目標Term具有自訂排序順序，然後附加來源Term排序順序。否則，如果目標Term沒有自訂排序順序，但沒有來源Term ，再根據 [目前的工作語言 ( WorkingLanguage) 英文字母順序強制自訂排序順序，附加來源Term自訂排序順序。
目前的使用者必須具備TaxonomyRights.EditTerm權限在目前的字詞和字詞合併才能使用這個方法。呼叫CommitAll()方法，將這項變更儲存至資料庫。