TermStore.GetTerms - Méthode (String, Int32, Boolean)

Article
03/15/2016

Retourne une collection de tous les objets de Term de tous les objets TermSet dans cette TermStore que l'utilisateur actuel est autorisé à lire avec une étiquette dans le LCID fourni correspond à la chaîne fournie.

Espace de noms : Microsoft.SharePoint.Taxonomy
Assembly : Microsoft.SharePoint.Taxonomy (dans Microsoft.SharePoint.Taxonomy.dll)

Syntaxe

'Déclaration
Public Function GetTerms ( _
    termLabel As String, _
    lcid As Integer, _
    trimUnavailable As Boolean _
) As TermCollection
'Utilisation
Dim instance As TermStore
Dim termLabel As String
Dim lcid As Integer
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection

returnValue = instance.GetTerms(termLabel, _
    lcid, trimUnavailable)

public TermCollection GetTerms(
    string termLabel,
    int lcid,
    bool trimUnavailable
)

Paramètres

termLabel
Type : System.String

Le Label de l' Term pour obtenir

lcid
Type : System.Int32

L'identificateur de paramètres régionaux de la Term des étiquettes pour être mis en correspondance.

trimUnavailable
Type : System.Boolean

Valeur booléenne indiquant s'il faut découper des termes qui ont la propriété IsAvailableForTagging la valeur false.

Valeur renvoyée

Type : Microsoft.SharePoint.Taxonomy.TermCollection
Une collection de tous les objets de T:Microsoft.SharePoint.Taxonomy.Term de tous les objets TermSet dans cet objet TermStore que l'utilisateur actuel est autorisé à lire avec un Label dans le LCID spécifié qui correspond à la chaîne fournie.

Exceptions

Exception	Condition
ArgumentNullException	Le termLabel ne peut pas être une référence Null (Rien dans Visual Basic) ou vide.
ArgumentException	La valeur de termLabel n'est pas valide. Probablement, il contient des caractères non valides ou est trop long.
ArgumentOutOfRangeException	La valeur de lcid doit être l'une des langues de travail dans le magasin de termes en cours.

Remarques

Si trimUnavailable est défini sur true, puis les termes qui ont le IsAvailableForTagging la valeur false seront réduits à partir des résultats ; Sinon, tous les termes seront renvoyées quelle que soit leur valeur IsAvailableForTagging . Tous les Term.Labels dans la langue correspondant au paramètre lcid sera recherchée par cette méthode. La recherche respecte la casse, et un maximum de 100 résultats sera retourné. Le termLabel ne peut pas être null ou vide et ne doit pas dépasser 255 caractères.Il ne doit pas contenir les caractères suivants : ;"<>|&tab.

La valeur de lcid doit être l'une des langues de travail de la banque de termes, spécifié par TermStore.Languages. Pour obtenir les résultats les plus précis, il est recommandé que toutes les modifications en attente soient validées dans la base de données à l'aide de CommitAll() avant l'exécution de cette recherche.