Term.CreateLabel - Méthode
Crée un nouveau Label pour ce Term.
Espace de noms : Microsoft.SharePoint.Taxonomy
Assembly : Microsoft.SharePoint.Taxonomy (dans Microsoft.SharePoint.Taxonomy.dll)
Syntaxe
'Déclaration
Public Function CreateLabel ( _
labelName As String, _
lcid As Integer, _
isDefault As Boolean _
) As Label
'Utilisation
Dim instance As Term
Dim labelName As String
Dim lcid As Integer
Dim isDefault As Boolean
Dim returnValue As Label
returnValue = instance.CreateLabel(labelName, _
lcid, isDefault)
public Label CreateLabel(
string labelName,
int lcid,
bool isDefault
)
Paramètres
labelName
Type : System.Stringnouveau nom de Label
lcid
Type : System.Int32Le LCID pour créer l'étiquette pour
isDefault
Type : System.BooleanSi cette Label est la valeur par défaut Label du lcid
Valeur renvoyée
Type : Microsoft.SharePoint.Taxonomy.Label
La nouvelle Label pour la Term
Exceptions
Exception | Condition |
---|---|
UnauthorizedAccessException | L'utilisateur ne dispose pas des autorisations suffisantes pour effectuer cette opération. |
TermStoreOperationException | Cette opération n'est pas valide dans les termes orphelins TermSet. L'opération a échoué. |
ArgumentException | Le nom d'étiquette n'est pas valide, il contient des caractères non valides ou est trop long. |
ArgumentNullException | Le nom d'étiquette est une référence Null (Rien dans Visual Basic) ou est une chaîne vide. |
ArgumentOutOfRangeException | Appelez la méthode M:Microsoft.SharePoint.Taxonomy.TermStore.CommitAll pour enregistrer cette modification dans la base de données. n'est pas valide. |
ArgumentException | L'étiquette est créée comme une none par défaut étiquette et le nom existe déjà pour ce lcid. |
Remarques
La valeur de labelName 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). Il doit être non vide, ne peut pas dépasser 255 caractères et ne peut contenir aucun le suivant caractères ;"< >|&tab
Le nom de l'objet Label n'est pas la casse. Si le nom doit être créé est un défaut non Label, il ne peut pas avoir le même nom que n'importe quel existant Label du lcid. S'il doit être créé en tant que valeur par défaut, il peut avoir le même nom que existant Label. Au lieu de créer une nouvelle étiquette, l'étiquette existante devient l'étiquette par défaut pour le LCID.
L'utilisateur actuel doit disposer des autorisations de TaxonomyRights.EditTerm d'utiliser cette méthode.