Método NamedRange.Consolidate

Artigo
01/09/2014

Consolida dados de vários intervalos em vários planilhas no controle de NamedRange .

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

Este exemplo é para uma personalização de um documento nível.

    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

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

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ável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via