NamedRange.Consolidate-Methode

  • Artikel

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

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
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
)

Parameter

  • Sources
    Typ: System.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
    Typ: System.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
    Typ: System.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
    Typ: System.Object
    true , um bei der Zusammenfassung die Arbeitsblattverknüpfungen zu verwenden; false, um bei der Zusammenfassung die Daten zu kopieren.Der Standardwert ist false.

Rückgabewert

Typ: System.Object

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird der Bereich der Zellen B1 bis D10 auf Zufallszahlen festgelegt. Anschließend wird dieser Bereich mithilfe der Consolidate-Methode zu einem NamedRange-Steuerelement zusammengefasst.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace