TermSetItem.CreateTerm - Méthode (String, Int32, Guid)
Crée un nouvel objet Term sous cet objet TaxonomyItem .Le nom est la valeur par défaut Label pour le LCID spécifié.
Espace de noms : Microsoft.SharePoint.Taxonomy
Assembly : Microsoft.SharePoint.Taxonomy (dans Microsoft.SharePoint.Taxonomy.dll)
Syntaxe
'Déclaration
Public Function CreateTerm ( _
name As String, _
lcid As Integer, _
newTermId As Guid _
) As Term
'Utilisation
Dim instance As TermSetItem
Dim name As String
Dim lcid As Integer
Dim newTermId As Guid
Dim returnValue As Term
returnValue = instance.CreateTerm(name, _
lcid, newTermId)
public Term CreateTerm(
string name,
int lcid,
Guid newTermId
)
Paramètres
name
Type : System.StringLibellé par défaut pour le lcid
lcid
Type : System.Int32LCID pour créer l'étiquette sur
newTermId
Type : System.GuidGUID pour le terme
Valeur renvoyée
Type : Microsoft.SharePoint.Taxonomy.Term
L'objet nouvellement créé Term
Exceptions
Exception | Condition |
---|---|
UnauthorizedAccessException | L'utilisateur actuel dispose d'autorisations insuffisantes pour effectuer cette opération. |
TermStoreOperationException | Cette opération n'est pas valide dans l'ensemble de termes termes orphelins.L'opération a échoué. |
TermStoreOperationException | Uniquement à la définition de termes mots clés autorise une liste plate de termes. |
ArgumentException | Le nom n'est pas valide, il contient des caractères non valides ou est trop long. |
ArgumentNullException | Le nom est une référence Null (Rien dans Visual Basic) ou chaîne vide. |
ArgumentOutOfRangeException | Le lcid n'est pas valide. |
Remarques
Si le LCID spécifié n'est pas la langue par défaut de l' TermStore, un Label avec le nom et la langue par défaut de la TermStore va également être créée pour assurer que la Term a une valeur par défaut Label la langue par défaut de l' TermStore.
Si le courant TermSetItem est l'ensemble de termes mots clés, étiquette est toujours créé pour la langue par défaut du magasin de termes.
La valeur de name sera normailized pour supprimer les espaces consécutifs en une seule et remplacez le caractère & par la version à caractère large du caractère (\uFF06). Les espaces de début et de fin seront supprimés. Il doit être non vide et ne doit pas dépasser 255 caractères et ne peut contenir aucun le suivant caractères ;"<>|&tab
L'utilisateur en cours sera défini comme le propriétaire de la nouvelle Term.
Si l' newTermId existe déjà dans le TermStore, une exception sera levée.
Si la TermSet de cette TaxonomyItem n'est pas une TermSet d' ouvrir l'utilisateur actuel doit avoir TaxonomyRights.EditTerm l'autorisation d'utiliser cette méthode. CommitAll() doit être appelé pour enregistrer cette modification dans la base de données.