Método NamedRange.Consolidate

Artigo
08/01/2011

Consolida dados de vários intervalos em várias planilhas para o NamedRange de controle.

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 da consolidação como uma matriz de seqüências de caracteres de referência de texto na notação de estilo L1C1.As referências devem incluir o caminho completo das planilhas a serem consolidados.

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

TopRow
Tipo: System.Object
true consolidar dados com base nos títulos de coluna na linha superior dos intervalos de consolidação; falseconsolidar dados por posição.O valor padrão é false.

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

CreateLinks
Tipo: System.Object
true Para fazer com que a consolidação use vínculos de planilha; falsepara que a consolidação de copiar os dados.O valor padrão é false.

Valor de retorno

Tipo: System.Object

Comentários

Optional Parameters

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

Exemplos

O exemplo de código a seguir define o intervalo de células de B1 a D10 números aleatórios e usa o Consolidate método para consolidar esse intervalo em um NamedRange de controle.

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

    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", missing],
        "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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via