NamedRange.Consolidate-Methode

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.

• Function
  Typ: System.Object
  Kann eine der folgenden XlConsolidationFunction-Konstanten sein:
  xlAverage
  xlCount
  xlCountNums
  xlMax
  xlMin
  xlProduct
  xlStDev
  xlStDevP
  xlSum
  xlVar
  xlVarP

• 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

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace