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

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

Microsoft.Office.Tools.Excel.dll

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: xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP

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.