Share via

Term.Move method

  • Article

Moves the current Term object to be a child of a different Term.

Namespace:  Microsoft.SharePoint.Client.Taxonomy
Assembly:  Microsoft.SharePoint.Client.Taxonomy (in Microsoft.SharePoint.Client.Taxonomy.dll)

Syntax

'Declaration
Public Sub Move ( _
    newParent As TermSetItem _
)
'Usage
Dim instance As Term
Dim newParent As TermSetItem

instance.Move(newParent)

public void Move(
    TermSetItem newParent
)

Parameters

Exceptions

Exception Condition
UnauthorizedAccessException

The current user has insufficient permissions to perform this operation.
ArgumentNullException

The new parent Term is a null reference (Nothing in Visual Basic).
ArgumentException

The new parent Term is invalid.
TermStoreOperationException

The Keyword TermSet object only allows a flat list of Term objects.
TermStoreOperationException

Moving to a TermSet for which other reused Term objects are disallowed.
TermStoreOperationException

Cannot move a Term to itself
TermStoreOperationException

Cannot move a Term to its descendent Term objects.
TermStoreOperationException

This operation is invalid in the orphaned terms term set.The operation failed.
TermStoreOperationException

Moving to a term set which has other reused instance of this Term is disallowed.

Remarks

This operation moves the current Term to become a child of another Term. Use the Move(TermSet) method to move the Term to become a child of TermSet.

The current user must have TaxonomyRights.EditTerm permission on both the current Term and the new parent Term to use this method. Call the CommitAll() method to save this change to the database.

See also

Reference

Term class

Term members

Microsoft.SharePoint.Client.Taxonomy namespace

Move(TermSet)