NamedRange.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 no controle NamedRange.

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 define o intervalo de células de B1 a D10 como números aleatórios e, em seguida, usa o Consolidate método para consolidar esse intervalo em um NamedRange controle .

Este exemplo destina-se a uma personalização no nível de documento.

private void SetConsolidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    Excel.Range Range1 = this.Range["B1", "D10"];
    Range1.Formula = "=rand()";

    string[] source = new string[] { "Sheet1!R1C2:R10C4" };
    namedRange1.Consolidate(source, Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Private Sub SetConsolidation()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1"), _
        "namedRange1")

    Dim Range1 As Excel.Range = Me.Range("B1", "D10")
    Range1.Formula = "=rand()"

    Dim [source]() As String = {"Sheet1!R1C2:R10C4"}
    namedRange1.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.