Метод TermSetItem.CreateTerm (String, Int32, Guid)

Статья
03/15/2016

Создает новый объект Term ниже этого объекта TaxonomyItem .Оно по умолчанию Label для указанного языка.

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

Синтаксис

'Декларация
Public Function CreateTerm ( _
    name As String, _
    lcid As Integer, _
    newTermId As Guid _
) As Term
'Применение
Dim instance As TermSetItem
Dim name As String
Dim lcid As Integer
Dim newTermId As Guid
Dim returnValue As Term

returnValue = instance.CreateTerm(name, _
    lcid, newTermId)

public Term CreateTerm(
    string name,
    int lcid,
    Guid newTermId
)

Параметры

name
Тип: System.String

Метки по умолчанию для языка

lcid
Тип: System.Int32

Код языка для создания метки на

newTermId
Тип: System.Guid

Идентификатор GUID для термина

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

Тип: Microsoft.SharePoint.Taxonomy.Term
Вновь созданный Term объект

Исключения

Исключение	Условие
UnauthorizedAccessException	Текущий пользователь имеет необходимые разрешения на выполнение этой операции.
TermStoreOperationException	Эта операция недопустима в наборе терминов Потерянные термины.Операция не выполнена.
TermStoreOperationException	Только набор терминов ключевых слов позволяет Неструктурированный список терминов.
ArgumentException	Имя не является допустимым, он содержит недопустимые знаки или имеет слишком большую длину.
ArgumentNullException	Имя — пустая ссылка (Nothing в Visual Basic) или пустой строкой.
ArgumentOutOfRangeException	Недопустимый идентификатор lcid.

Замечания

Если указанный атрибут LCID не язык по умолчанию для TermStore, Label с именем и язык по умолчанию для TermStore будет создан для убедитесь, что Term по умолчанию Label для языка по умолчанию TermStore.

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

Значение name будет normailized монтажа последовательных пробелов в одну и заменить символ & версии расширенных символов знака (\uFF06). Начальные и конечные пробелы будут обрезаны. Должен быть пустым и не может превышать 255 символов и не должно содержать следующих знаков ;"<>|&tab

Текущий пользователь будет установлен в качестве владельца нового Term.

Если newTermId уже существует в TermStore, будет создано исключение.

Если TermSet для этого TaxonomyItem не TermSet открыть текущий пользователь должен иметь разрешение TaxonomyRights.EditTerm для использования этого метода. Чтобы сохранить эти изменения в базу данных необходимо вызвать CommitAll() .

См. также

Справочные материалы

TermSetItem класс

Элементы TermSetItem

Перегрузка CreateTerm

Пространство имен Microsoft.SharePoint.Taxonomy

Поделиться через