Term.Move Method (Term)
Moves the current T:Microsoft.SharePoint.Taxonomy.Term object to be a child of a different Term.
Namespace: Microsoft.SharePoint.Taxonomy
Assembly: Microsoft.SharePoint.Taxonomy (in Microsoft.SharePoint.Taxonomy.dll)
Syntax
'Declaration
Public Sub Move ( _
newParentTerm As Term _
)
'Usage
Dim instance As Term
Dim newParentTerm As Term
instance.Move(newParentTerm)
public void Move(
Term newParentTerm
)
Parameters
newParentTerm
Type: Microsoft.SharePoint.Taxonomy.TermThe new parent Term
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.