Term.Merge - Méthode

SharePoint 2013

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)

public Term Merge(
	Term termToMerge
)

Paramètres

termToMerge
Type : Microsoft.SharePoint.Taxonomy.Term

L' actuel Term

Valeur renvoyée

Type : Microsoft.SharePoint.Taxonomy.Term
La fusion Term

ExceptionCondition
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.

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.

Afficher: