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 のNothing )です。 |
| ArgumentException | 結合するTermが正しくありません。 |
| TermStoreOperationException | この操作は、孤立した用語TermSetオブジェクトでは有効ではありません。処理に失敗しました。 |
| TermStoreOperationException | Termに、再利用するにはTermを結合することはできません。 |
| TermStoreOperationException | のみをソースTermは、別のソースTermにマージすることができます。 |
| TermStoreOperationException | 2 つの指定されたTermオブジェクトは、結合することはできません。ソースTerm差し込みの対象TermTermSetオブジェクトが同じで再利用およびになる差し込み可能なために、そのTermSetの兄弟をする必要があります。 |
| UnauthorizedAccessException | 現在のユーザーは、この操作を実行する十分なアクセス許可を持ちます。 |
注釈
現在TermTermから、差し込み印刷するは、 termToMerge ( Termターゲット) に結合するTermします。**Merge()**操作が完了したら、両方のTermオブジェクトの再利用できるようになる、およびtargetTerm再利用Termオブジェクトのソースになります。ターゲットTermGUIDでは、結合されたTermの GUID になります。現在Term GUID がMergedTermIdsに追加されます。
現在のTermまたは再利用のコピーのいずれかの親のユーザー設定の並べ替え順序でTerm GUIDターゲットTerm GUIDが更新されます。
ユーザー設定の並べ替え順序は次のように結合: ターゲットTermが、ユーザー設定の並べ替え順序をする場合、ソースTermの並べ替え順序が追加されます。それ以外の場合、ターゲットTermには、ユーザー設定の並べ替え順序がない場合は、ソースTermは、[ユーザー設定の並べ替え順序が効力を現在の作業言語 ( WorkingLanguage) にアルファベット順に基づく、ソースTermユーザー設定の並べ替え順序が追加されます。
現在のユーザーにこの方法を使用するために差し込む現在の用語と用語の両方でTaxonomyRights.EditTermのアクセス許可が必要です。データベースにこの変更を保存するCommitAll()メソッドを呼び出します。