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

Article
03/15/2016

Retourne toutes les instances de termes qui sont les descendants du terme en cours avec une étiquette dans le lcid fourni correspond à la chaîne fournie. Il vérifie seulement les libellés par défaut si defaultLabelOnly est fourni pour avoir la valeur true.

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, _
    defaultLabelOnly As Boolean, _
    stringMatchOption As StringMatchOption, _
    resultCollectionSize As Integer, _
    trimUnavailable As Boolean _
) As TermCollection
'Utilisation
Dim instance As Term
Dim termLabel As String
Dim lcid As Integer
Dim defaultLabelOnly As Boolean
Dim stringMatchOption As StringMatchOption
Dim resultCollectionSize As Integer
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection

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

public TermCollection GetTerms(
    string termLabel,
    int lcid,
    bool defaultLabelOnly,
    StringMatchOption stringMatchOption,
    int resultCollectionSize,
    bool trimUnavailable
)

Paramètres

termLabel
Type : System.String

l'étiquette du terme doit correspondre au

lcid
Type : System.Int32

Cette méthode recherche uniquement les étiquettes dans ce lcid.

defaultLabelOnly
Type : System.Boolean

Si vous souhaitez rechercher uniquement les libellés par défaut

stringMatchOption
Type : Microsoft.SharePoint.Taxonomy.StringMatchOption

Si la recherche est exacte ou démarrer avec

resultCollectionSize
Type : System.Int32

nombre maximal de résultats renvoyés

trimUnavailable
Type : System.Boolean

Si vous souhaitez inclure les valeurs non disponible pour le marquage à terme dans les résultats

Valeur renvoyée

Type : Microsoft.SharePoint.Taxonomy.TermCollection
La TermCollection qui correspond à des critères de la recherche

Exceptions

Exception	Condition
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	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 null ou une chaîne vide.

Remarques

La valeur de termLabel sera normailized pour supprimer les espaces consécutifs en une seule et remplacer le & caractère avec la version à caractère large du caractère (\uFF06). Il doit être non vide et ne doit pas dépasser 255 caractères et ne peut pas contenir anyof caractères suivants ; « < > | & onglet

Les résultats de la recherche sont directement à partir de la banque de termes. Il n'est peut-être pas synchronisé avec toutes les modifications qui ont été apportées, mais ne pas validées. Pour obtenir de le bestresults, appel CommitAll ou RollbackAll avant d'appeler cette méthode.