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
termToMerge
Tipo: Microsoft.SharePoint.Client.Taxonomy.TermO atual Term
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.