NamedRange.Consolidate(Object, Object, Object, Object, Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Excel

Zestaw:: Microsoft.Office.Tools.Excel.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Konsoliduje dane z wielu zakresów w wielu arkuszach do kontrolki 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

Parametry

Sources: Object

Źródła konsolidacji jako tablica ciągów odwołań tekstowych w notacji w stylu R1C1. Odwołania muszą zawierać pełną ścieżkę arkuszy do skonsolidowania.

Function: Object

Może być jedną z następujących XlConsolidationFunction stałych: xlAverage xlCount xlCountNums xlMax xlMin xlProduct xlStDev xlStDevP xlSum xlVar xlVarP

TopRow: Object

true konsolidować dane na podstawie tytułów kolumn w górnym wierszu zakresów konsolidacji; false aby skonsolidować dane według pozycji. Wartość domyślna to false.

LeftColumn: Object

true konsolidować dane na podstawie tytułów wierszy w lewej kolumnie zakresów konsolidacji; false aby skonsolidować dane według pozycji. Wartość domyślna to false.

CreateLinks: Object

true aby konsolidacja korzystała z linków arkusza; false aby konsolidacja skopiowała dane. Wartość domyślna to false.

Zwraca

Object

Przykłady

Poniższy przykład kodu ustawia zakres komórek od B1 do D10 do liczb losowych, a następnie używa Consolidate metody do skonsolidowania tego zakresu w kontrolce NamedRange .

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.

Dotyczy