Term.Merge - Méthode
Fusionner l'objet Term en cours avec la spécifiée Term et renvoyer le combiné Term.
Espace de noms : Microsoft.SharePoint.Client.Taxonomy
Assemblys : Microsoft.SharePoint.Client.Taxonomy.Silverlight (dans Microsoft.SharePoint.Client.Taxonomy.Silverlight.dll); Microsoft.SharePoint.Client.Taxonomy.Phone (dans Microsoft.SharePoint.Client.Taxonomy.Phone.dll) Microsoft.SharePoint.Client.Taxonomy (dans Microsoft.SharePoint.Client.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.Client.Taxonomy.TermLa Term en cours
Valeur renvoyée
Type : Microsoft.SharePoint.Client.Taxonomy.Term
La fusionnées Term
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | Term à fusionner est une référence Null (Rien dans Visual Basic). |
| ArgumentException | Term à fusionner n'est pas valide. |
| TermStoreOperationException | Cette opération n'est pas valide dans l'objet 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és dans une 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 et publipostage sont réutilisées dans le même objet TermSet et doivent être frères dans ce TermSet pour être fusionnable. |
| UnauthorizedAccessException | L'utilisateur actuel dispose des autorisations suffisantes pour effectuer cette opération. |
Remarques
L' actuel Term est Term pour fusionner avec et le termToMergeTerm à fusionner (cible Term). Une fois l'opération Merge() est terminée, les deux objets Term deviennent réutilisés et la targetTerm devient la source des objets réutilisé Term . La cible TermGUID devient le GUID de la fusionnées Term. En cours Term GUID est ajouté à MergedTermIds
Term GUID dans l'ordre de tri personnalisé des parents de l' actuel Term ou une de ses copies réutilisés est mis à jour avec la cible Term GUID.
L'ordre de tri personnalisé fusionné de la manière suivante : si la cible Term contient un ordre de tri personnalisé, puis l'ordre de tri Term source est ajouté à la fin. Dans le cas contraire, si la cible Term n'a pas un ordre de tri personnalisé Contrairement à la source Term , puis un ordre de tri personnalisé est appliqué en fonction de 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 disposer d'autorisation TaxonomyRights.EditTerm sur le terme en cours et le terme à fusionner pour pouvoir utiliser cette méthode. Appeler la méthode CommitAll() pour enregistrer cette modification dans la base de données.