NamedRange.Consolidate-Methode

Artikel
08/10/2011

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", missing],
        "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

Share via