Метод Term.Merge
Объединить текущий объект Term с указанным Term и возвращает объединенный Term.
Пространство имен: Microsoft.SharePoint.Taxonomy
Сборка: Microsoft.SharePoint.Taxonomy (в Microsoft.SharePoint.Taxonomy.dll)
Синтаксис
'Декларация
Public Function Merge ( _
termToMerge As Term _
) As Term
'Применение
Dim instance As Term
Dim termToMerge As Term
Dim returnValue As Term
returnValue = instance.Merge(termToMerge)
public Term Merge(
Term termToMerge
)
Параметры
termToMerge
Тип: Microsoft.SharePoint.Taxonomy.TermТекущий Term
Возвращаемое значение
Тип: Microsoft.SharePoint.Taxonomy.Term
Объединенные Term
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Term объединение является пустая ссылка (Nothing в Visual Basic). |
| ArgumentException | Term объединение является недопустимым. |
| TermStoreOperationException | Эта операция недопустима в объекте TermSet Потерянные термины.Операция не выполнена. |
| TermStoreOperationException | Не удается объединить Term с его повторно используемым Term. |
| TermStoreOperationException | Только источник Term могут быть объединены в другой источник Term. |
| TermStoreOperationException | Слияние двух объектов заданного Term запрещено. Источник Term целевой Term , объединения используются повторно в один и тот же объект TermSet и должен быть того же уровня в этой TermSet , чтобы быть объединяемые. |
| UnauthorizedAccessException | Текущий пользователь имеет необходимые разрешения на выполнение этой операции. |
Замечания
Текущий Term — Term для слияния из, а termToMerge — Term объединение (целевой Term). После завершения операции **Merge()**targetTerm становится источником объектов повторно используемые Term и Term объекты становятся многократно. Целевой объект TermGUID становится GUID объединенных Term. Текущий Term идентификатор GUID добавляется в MergedTermIds
Term GUID в порядок сортировки родительских элементов текущей Term и любых его повторно используемым копий обновляется целевой объект Term GUID.
Порядок сортировки объединяются следующим образом: Если целевой объект Term имеет пользовательский порядок сортировки, то порядок сортировки источника Term добавляется к нему. В противном случае если целевой Term не имеет специального порядка сортировки, но не исходного Term , пользовательский порядок сортировки применяется на основе алфавитного порядка текущего рабочего языка ( WorkingLanguage) и порядок сортировки источника Term добавляется к нему.
Текущий пользователь должен иметь разрешение TaxonomyRights.EditTerm для текущего термина и термин объединение для использования этого метода. Вызовите метод CommitAll() , чтобы сохранить эти изменения в базу данных.