Term.Merge - Méthode
Fusionner l'objet Term en cours avec le spécifié Term et renvoyer le combiné Term.
Espace de noms : Microsoft.SharePoint.Taxonomy
Assembly : Microsoft.SharePoint.Taxonomy (dans Microsoft.SharePoint.Taxonomy.dll)
Syntaxe
'Déclaration
Public Function Merge ( _
termToMerge As Term _
) As Term
'Utilisation
Dim instance As Term
Dim termToMerge As Term
Dim returnValue As Term
returnValue = instance.Merge(termToMerge)
public Term Merge(
Term termToMerge
)
Paramètres
termToMerge
Type : Microsoft.SharePoint.Taxonomy.TermL' actuel Term
Valeur renvoyée
Type : Microsoft.SharePoint.Taxonomy.Term
La fusion Term
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | La Term à fusionner est une référence Null (Rien dans Visual Basic). |
| ArgumentException | La Term à fusionner n'est pas valide. |
| TermStoreOperationException | Cette opération n'est pas valide dans l'objet de TermSet termes orphelins.L'opération a échoué. |
| TermStoreOperationException | Impossible de fusionner un Term à son réutilisé Term. |
| TermStoreOperationException | Uniquement une source Term peuvent être fusionnées dans un autre source Term. |
| TermStoreOperationException | Fusion n'est pas autorisée pour les deux objets spécifié Term . La source Term la cible Term de fusion sont réutilisés dans le même objet de TermSet et doivent être frères dans ce TermSet pour être fusionnable. |
| UnauthorizedAccessException | L'utilisateur actuel dispose d'autorisations insuffisantes pour effectuer cette opération. |
Remarques
L' actuel Term est le Term à fusionner à partir de, et le termToMerge est le Term à fusionner (la cible Term). Une fois l'opération Merge() est terminée, les deux objets de Term deviennent réutilisés et la targetTerm devient la source des objets réutilisés Term . La cible TermGUID devient le GUID de la fusion Term. L' actuel Term GUID est ajouté à MergedTermIds
Le Term GUID dans l'ordre de tri personnalisé des parents de l' actuel Term ou l'un de ses copies réutilisés est mis à jour avec la cible Term GUID.
L'ordre de tri personnalisé est fusionné de la manière suivante : si la cible Term a un ordre de tri personnalisé, puis l'ordre de tri de source Term est ajouté à la fin. Dans le cas contraire, si la cible Term ne dispose pas d'un ordre de tri personnalisé Contrairement à la source Term , puis un ordre de tri personnalisé est appliqué selon l'ordre alphabétique dans la langue de travail en cours ( WorkingLanguage) et l'ordre de tri personnalisé Term source est ajouté à la fin.
L'utilisateur actuel doit avoir l'autorisation TaxonomyRights.EditTerm sur le terme en cours et le terme à fusionner dans cette méthode. Appelez la méthode CommitAll() pour enregistrer cette modification dans la base de données.