Compartilhar via


Term.Merge método

Mesclar o objeto de Term atual com o especificado Term e retornar o combinado Term.

Namespace:  Microsoft.SharePoint.Client.Taxonomy
Assemblies:   Microsoft.SharePoint.Client.Taxonomy.Silverlight (em Microsoft.SharePoint.Client.Taxonomy.Silverlight.dll);  Microsoft.SharePoint.Client.Taxonomy.Phone (em Microsoft.SharePoint.Client.Taxonomy.Phone.dll)  Microsoft.SharePoint.Client.Taxonomy (em Microsoft.SharePoint.Client.Taxonomy.dll)

Sintaxe

'Declaração
Public Function Merge ( _
    termToMerge As Term _
) As Term
'Uso
Dim instance As Term
Dim termToMerge As Term
Dim returnValue As Term

returnValue = instance.Merge(termToMerge)
public Term Merge(
    Term termToMerge
)

Parâmetros

Valor retornado

Tipo: Microsoft.SharePoint.Client.Taxonomy.Term
O mescladas Term

Exceções

Exceção Condição
ArgumentNullException

O Term mesclar em é uma referência nula (Nothing no Visual Basic).

ArgumentException

O Term mesclar em é inválido.

TermStoreOperationException

Esta operação é inválida no objeto TermSet termos órfãos. A operação falhou.

TermStoreOperationException

Não é possível mesclar um Term para seu reutilizadas Term.

TermStoreOperationException

Somente uma fonte Term podem ser mescladas em outro origem Term.

TermStoreOperationException

Não é permitido Mesclar para os dois objetos especificado Term . A fonte Term o destino Term da mesclagem são reutilizados no mesmo objeto TermSet e deve ser irmãos em que TermSet para ser mesclável.

UnauthorizedAccessException

O usuário atual tem permissões suficientes para executar essa operação.

Comentários

O atual Term é o Term para mesclar a partir e o termToMerge é o Term mesclar em (o destino Term). Após a conclusão da operação de Merge() , ambos os objetos Term ficam reutilizados e o targetTerm se torna a origem dos objetos reutilizadas Term . O destino TermGUID torna-se o GUID do mescladas Term. O atual Term GUID é adicionado à MergedTermIds

O Term GUID na ordem de classificação personalizada dos pais o atual Term ou quaisquer de suas cópias reutilizadas é atualizado com o destino Term GUID.

A ordem de classificação personalizada é mesclada da seguinte forma: se o destino Term tem uma ordem de classificação personalizada, a ordem de classificação de Term de origem é acrescentada a ele. Caso contrário, se o destino Term não tem uma ordem de classificação personalizada, mas a fonte Term faz, então uma ordem de classificação personalizada é aplicada a baseado em ordem alfabética no idioma trabalho atual ( WorkingLanguage), e a ordem de classificação personalizada de Term de origem é acrescentada a ele.

O usuário atual deve ter permissão de TaxonomyRights.EditTerm sobre o termo atual e o termo para mesclar para poder usar esse método. Chame o método CommitAll() para salvar essa alteração no banco de dados.

Ver também

Referência

Term classe

Term membros

Microsoft.SharePoint.Client.Taxonomy namespace