Метод TermSet.GetTerms (String, Int32, Boolean)

Статья
03/15/2016

Возвращает коллекцию объектов Term из текущего объекта TermSet с Label в указанный атрибут LCID соответствия предоставленной строке.

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

Синтаксис

'Декларация
Public Function GetTerms ( _
    termLabel As String, _
    lcid As Integer, _
    trimUnavailable As Boolean _
) As TermCollection
'Применение
Dim instance As TermSet
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
)

Параметры

termLabel
Тип: System.String

Label для Term для получения

lcid
Тип: System.Int32

Идентификатор языкового стандарта Labels для сравнения.

trimUnavailable
Тип: System.Boolean

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

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

Тип: Microsoft.SharePoint.Taxonomy.TermCollection
Коллекция всех объектов Term из текущего TermSet с Label объектом в предоставленный идентификатор LCID соответствия предоставленной строке.

Исключения

Исключение	Условие
ArgumentNullException	termLabel не может быть пустая ссылка (Nothing в Visual Basic) или.
ArgumentException	Недопустимое значение termLabel . Скорее всего, содержит недопустимые знаки или имеет слишком большую длину.
ArgumentOutOfRangeException	Значение lcid должно быть одним из языков, работы в текущем объекте TermStore .

Замечания

Если trimUnavailabletrue, затем Term объектов с установленным свойством IsAvailableForTagging для false будут удалены из результатов; в противном случае будут возвращены все объекты Term независимо от значения свойства IsAvailableForTagging . Этот метод будет осуществлять поиск всех объектов Term.Label язык, соответствующий параметру lcid .Поиск без учета регистра. Будет возвращено более 100 результатов поиска по ключевым словам.termLabel не может быть пустая ссылка (Nothing в Visual Basic) или пустой и не должна превышать 255 знаков в длину. Он также не может содержать следующие недопустимые символы ; "< >|&tab. Значение lcid должно быть одним из рабочих языков TermStore объекта, указанного в свойстве Languages() . Чтобы получить наиболее точные результаты, корпорация Майкрософт рекомендует перед выполнением поиска зафиксировать изменения в базе данных с помощью метода CommitAll() .