Método XmlMappedRange.Consolidate

Artigo
05/21/2013

Consolida dados de vários intervalos em vários planilhas em um controle de XmlMappedRange .

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Consolidate ( _
    Sources As Object, _
    Function As Object, _
    TopRow As Object, _
    LeftColumn As Object, _
    CreateLinks As Object _
) As Object

Object Consolidate(
    Object Sources,
    Object Function,
    Object TopRow,
    Object LeftColumn,
    Object CreateLinks
)

Parâmetros

Sources
Tipo: System.Object
As fontes de consolidação como uma matriz de texto em cadeias de caracteres na notação de R1C1-style.As referências devem incluir o caminho completo das folhas a ser consolidadas.

Function
Tipo: System.Object
Pode ser uma das seguintes constantes de XlConsolidationFunction :
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlVar
xlVarP

TopRow
Tipo: System.Object
true para consolidar os dados com base em títulos de coluna na linha superior de consolidação varia; false para consolidar dados por posição.O valor padrão é false.

LeftColumn
Tipo: System.Object
true para consolidar os dados com base em títulos de linha na coluna esquerda de consolidação varia; false para consolidar dados por posição.O valor padrão é false.

CreateLinks
Tipo: System.Object
true para ter a planilha do uso de consolidação links; false para ter a cópia de consolidação os dados.O valor padrão é false.

Valor de retorno

Tipo: System.Object

Comentários

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir usa o método de Consolidate para consolidar os valores da célula A1 em Sheet2 e da célula A1 em Sheet3 em XmlMappedRange em Sheet1.O exemplo consolida os valores adicionando os valores juntos.Este exemplo de código a seguir pressupõe que Sheet1 contém XmlMappedRange chamado CustomerLastNameCell.

Private Sub ConsolidateCells()
    Globals.Sheet2.Range("A1").Value2 = 1710
    Globals.Sheet3.Range("A1").Value2 = 1240

    Dim Source As String() = {"Sheet2!R1C1", "Sheet3!R1C1"}
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(Source, _
        Excel.XlConsolidationFunction.xlSum, False, False, False)
End Sub

private void ConsolidateCells()
{
    Globals.Sheet2.Range["A1"].Value2 = 1710;
    Globals.Sheet3.Range["A1"].Value2 = 1240;

    string[] source = new string[] { "Sheet2!R1C1", "Sheet3!R1C1" };
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(source, 
        Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

XmlMappedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via