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


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

Создает новый объект 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