Метод 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() .