Share via


Term.ReassignSourceTerm method

Reassigns the source term status to one of the other reused instances of this Term object.

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

Syntax

'Declaration
Public Sub ReassignSourceTerm ( _
    reusedTerm As Term _
)
'Usage
Dim instance As Term
Dim reusedTerm As Term

instance.ReassignSourceTerm(reusedTerm)
public void ReassignSourceTerm(
    Term reusedTerm
)

Parameters

Exceptions

Exception Condition
UnauthorizedAccessException

The current user has insufficient permissions to perform this operation.

ArgumentNullException

The reused Term to become the new source is a null reference (Nothing in Visual Basic) or invalid.

TermStoreOperationException

The current Term must be the source term to reassign the current setting to another Term.

TermStoreOperationException

Cannot reassign the source Term to itself

ArgumentException

The reusedTerm must be a member of the ReusedTerms collection for this Term.

Remarks

This method is only valid if the current Term is the source Term. It is expected that this method is used before attempting to delete a source Term.

The current user must have TaxonomyRights.EditTerm permission on the current Term and on the new source Term to use this method. With the exception where the source Term is in the orphaned TermSet, anyone with TaxonomyRights.EditTerm permission on the new source Term can use this method. If the source Term is in the orphaned TermSet and the operation succeeded, then the old source Term is removed from the orphaned TermSet. Call the CommitAll() must be called to save this change to the database.

See also

Reference

Term class

Term members

Microsoft.SharePoint.Taxonomy namespace

IsSourceTerm

ReusedTerms