Term.ReassignSourceTerm method
Reassigns the source term status to one of the other reused instances of this Term object.
Namespace: Microsoft.SharePoint.Client.Taxonomy
Assembly: Microsoft.SharePoint.Client.Taxonomy (in Microsoft.SharePoint.Client.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
reusedTerm
Type: Microsoft.SharePoint.Client.Taxonomy.TermOne of the Term objects from the ReusedTerms collection should become the new source term.
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.