NamedRange.Consolidate(Object, Object, Object, Object, Object) Methode

Definition

Fasst Daten aus mehreren Bereichen auf mehreren Arbeitsblättern in dem NamedRange-Steuerelement zusammen.

public object Consolidate (object Sources, object Function, object TopRow, object LeftColumn, object CreateLinks);

Parameter

Sources
Object

Die Quellen der Zusammenfassung als ein Array von Textbezugszeichenketten in Z1S1-Notation. Die Bezüge müssen den vollständigen Pfad der zusammenzufassenden Blätter enthalten.

TopRow
Object

true, um die Daten nach den Spaltenüberschriften in der obersten Zeile der Zusammenfassungsbereiche zusammenzufassen; false, um die Daten der Position nach zusammenzufassen. Der Standardwert ist false.

LeftColumn
Object

true, um die Daten nach den Zeilenüberschriften in der linken Spalte der Zusammenfassungsbereiche zusammenzufassen; false, um die Daten der Position nach zusammenzufassen. Der Standardwert ist false.

CreateLinks
Object

true, um bei der Zusammenfassung die Arbeitsblattverknüpfungen zu verwenden; false, um bei der Zusammenfassung die Daten zu kopieren. Der Standardwert ist false.

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird der Zellen Bereich von B1 bis D10 auf Zufallszahlen festgelegt, und anschließend wird die- Consolidate Methode verwendet, um diesen Bereich in einem-Steuerelement zu konsolidieren NamedRange .

Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.

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

Hinweise

Optionale Parameter

Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.

Gilt für