TermStore.GetTermsWithCustomProperty - Méthode (String, String, Boolean)
Obtient une collection de tous les objets Term , à partir de tous les objets TermSet dans cet objet TermStore que l'utilisateur actuel est autorisé à lire, qui ont une propriété personnalisée avec le nom de propriété spécifié et la valeur de propriété spécifiée.
Espace de noms : Microsoft.SharePoint.Taxonomy
Assembly : Microsoft.SharePoint.Taxonomy (dans Microsoft.SharePoint.Taxonomy.dll)
Syntaxe
'Déclaration
Public Function GetTermsWithCustomProperty ( _
customPropertyName As String, _
customPropertyValue As String, _
trimUnavailable As Boolean _
) As TermCollection
'Utilisation
Dim instance As TermStore
Dim customPropertyName As String
Dim customPropertyValue As String
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection
returnValue = instance.GetTermsWithCustomProperty(customPropertyName, _
customPropertyValue, trimUnavailable)
public TermCollection GetTermsWithCustomProperty(
string customPropertyName,
string customPropertyValue,
bool trimUnavailable
)
Paramètres
customPropertyName
Type : System.StringLe nom de propriété personnalisée
customPropertyValue
Type : System.StringLa valeur de la propriété personnalisée
trimUnavailable
Type : System.BooleanValeur booléenne indiquant s'il faut découper des termes qui ont Term.IsAvailableForTagging la valeur false.
Valeur renvoyée
Type : Microsoft.SharePoint.Taxonomy.TermCollection
Une collection de tous les objets Term , à partir de tous les objets de TermSet de cette TermStore que l'utilisateur actuel est autorisé à lire, qui ont une propriété personnalisée avec le nom de propriété fourni et la valeur de la propriété fournie
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | Le customPropertyName ne peut pas être null ou vide. |
ArgumentException | La valeur de customPropertyName n'est pas valide. Probablement, il contient des caractères non valides ou est trop long. |
ArgumentNullException | Le customPropertyValue ne peut pas être null ou vide. |
ArgumentException | La valeur de customPropertyValue n'est pas valide. Elle dépasse la longueur maximale autorisée 255. |
ArgumentException | La valeur de customPropertyValue n'est pas valide. Il contient le caractère non valide '\t', '\n' ou les deux. |
Remarques
Si trimUnavailable a la valeur true les termes qui ont Term.IsAvailableForTagging la valeur false seront trimmedfrom les résultats ; Sinon, tous les termes correspondants seront renvoyées quelle que soit leur valeur Term.IsAvailableForTagging. Le customPropertyName ne peut pas être une référence Null (Rien dans Visual Basic) ou vide et ne doit pas dépasser 255 caractères.Il ne doit pas contenir de la suivante caractères illégaux ;"<>|&tab le customPropertyValue ne peut pas être null ou vide et ne doit pas dépasser 255 caractères. Il ne doit pas contenir des caractères non autorisés \t ou \n. La recherche respecte la casse. Un maximum de 100 résultats sera retourné à partir de cette recherche. 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.
Voir aussi
Référence
GetTermsWithCustomProperty - Surcharge
Microsoft.SharePoint.Taxonomy - Espace de noms
GetTermsWithCustomProperty(String, Boolean)
GetTermsWithCustomProperty(String, Int32, Boolean)
GetTermsWithCustomProperty(String, String, StringMatchOption, Boolean)
GetTermsWithCustomProperty(String, String, StringMatchOption, Int32, Boolean)