Метод TermSet.GetTermsWithCustomProperty (String, String, StringMatchOption, Boolean)

Статья
03/15/2016

Возвращает коллекцию объектов Term с пользовательским свойством начиная с или соответствующих предоставленному имени свойства и значение указанного свойства.

Пространство имен: Microsoft.SharePoint.Taxonomy
Сборка: Microsoft.SharePoint.Taxonomy (в Microsoft.SharePoint.Taxonomy.dll)

Синтаксис

'Декларация
Public Function GetTermsWithCustomProperty ( _
    customPropertyName As String, _
    customPropertyValue As String, _
    stringMatchOption As StringMatchOption, _
    trimUnavailable As Boolean _
) As TermCollection
'Применение
Dim instance As TermSet
Dim customPropertyName As String
Dim customPropertyValue As String
Dim stringMatchOption As StringMatchOption
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection

returnValue = instance.GetTermsWithCustomProperty(customPropertyName, _
    customPropertyValue, stringMatchOption, _
    trimUnavailable)

public TermCollection GetTermsWithCustomProperty(
    string customPropertyName,
    string customPropertyValue,
    StringMatchOption stringMatchOption,
    bool trimUnavailable
)

Параметры

customPropertyName
Тип: System.String

Имя пользовательского свойства

customPropertyValue
Тип: System.String

Значение пользовательского свойства

stringMatchOption
Тип: Microsoft.SharePoint.Taxonomy.StringMatchOption

Следует ли поиск пользовательские имена свойств и значений, начинающихся с указанной строки или те, которые точно соответствуют указанной строки.

trimUnavailable
Тип: System.Boolean

Логическое значение, определяющее необходимость обрезать Term объекты, имеющие свойство IsAvailableForTagging значение false.

Возвращаемое значение

Тип: Microsoft.SharePoint.Taxonomy.TermCollection
Коллекция Term объектов с помощью пользовательского свойства, начиная с или соответствующих предоставленному имени свойства и значение указанного свойства.

Исключения

Исключение	Условие
ArgumentNullException	customPropertyName не может быть пустая ссылка (Nothing в Visual Basic) или.
ArgumentException	Недопустимое значение customPropertyName . Скорее всего, содержит недопустимые знаки или имеет слишком большую длину.
ArgumentNullException	customPropertyValue не может быть пустая ссылка (Nothing в Visual Basic) или.
ArgumentException	Недопустимое значение customPropertyValue . Он превышает максимально допустимую длину в 255.
ArgumentException	Недопустимое значение customPropertyValue . Он содержит недопустимый символ \tи \n.

Замечания

Если trimUnavailabletrue, затем Term объектов с установленным свойством IsAvailableForTagging для false будут удалены из результатов; в противном случае будут возвращены все совпадающие слова независимо от значения свойства IsAvailableForTagging . customPropertyName не может быть пустая ссылка (Nothing в Visual Basic) или пустой и не должна превышать 255 знаков в длину. Он также не может содержать следующие недопустимые символы:tab; "<>|&.

customPropertyValue не может быть пустая ссылка (Nothing в Visual Basic) или пустой и не должна превышать 255 знаков в длину. Он также не может содержать недопустимые символы \t или \n.Поиск без учета регистра. Будет возвращено более 100 результатов поиска по ключевым словам. Чтобы получить наиболее точные результаты, корпорация Майкрософт рекомендует использовать метод CommitAll() для сохранения изменений в базе данных перед выполнением поиска.