XmlMappedRange.Consolidate(Object, Object, Object, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

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

public object Consolidate (object Sources, object Function, object TopRow, object LeftColumn, object CreateLinks);

abstract member Consolidate : obj * obj * obj * obj * obj -> obj

Public Function Consolidate (Optional Sources As Object, Optional Function As Object, Optional TopRow As Object, Optional LeftColumn As Object, Optional CreateLinks As Object) As Object

Parâmetros

Sources

Object

As fontes da consolidação como uma matriz de cadeias de caracteres de referência de texto na notação de estilo R1C1. As referências devem incluir o caminho completo das planilhas a serem consolidadas.

Function

Object

Pode ser uma das seguintes XlConsolidationFunction constantes: xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP

TopRow

Object

true para consolidar dados com base nos títulos das colunas na linha superior dos intervalos de consolidação, false para consolidar dados pela posição. O valor padrão é false.

LeftColumn

Object

true para consolidar dados com base nos títulos das linhas na coluna da esquerda dos intervalos de consolidação, false para consolidar dados pela posição. O valor padrão é false.

CreateLinks

Object

true para fazer com que a consolidação use links de planilha, false para fazer com que a consolidação copie os dados. O valor padrão é false.

Retornos

Object

Exemplos

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

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);
}

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

Comentários

Parâmetros Opcionais

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