NamedRange.Subtotal-Methode

Artikel
08/10/2011

Erstellt Teilergebnisse für das NamedRange-Steuerelement.

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

Syntax

'Declaration
Function Subtotal ( _
    GroupBy As Integer, _
    Function As XlConsolidationFunction, _
    TotalList As Object, _
    Replace As Object, _
    PageBreaks As Object, _
    SummaryBelowData As XlSummaryRow _
) As Object

Object Subtotal(
    int GroupBy,
    XlConsolidationFunction Function,
    Object TotalList,
    Object Replace,
    Object PageBreaks,
    XlSummaryRow SummaryBelowData
)

Parameter

GroupBy
Typ: System.Int32
Das Feld, nach dem gruppiert werden soll, als Ganzzahloffset mit der Basis eins.

Function
Typ: Microsoft.Office.Interop.Excel.XlConsolidationFunction
Die Teilergebnisfunktion.
Kann einer der folgenden XlConsolidationFunction-Werte sein:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlUnknown
xlVar
xlVarP

TotalList
Typ: System.Object
Ein Array von Feldoffsets mit der Basis eins. Es werden die Felder angeben, denen die Teilergebnisse hinzugefügt werden sollen.

Replace
Typ: System.Object
true, um vorhandene Teilergebnisse zu ersetzen.Der Standardwert ist false.

PageBreaks
Typ: System.Object
true, um nach jeder Gruppe einen Seitenumbruch hinzuzufügen.Der Standardwert ist false.

SummaryBelowData
Typ: Microsoft.Office.Interop.Excel.XlSummaryRow
Fügt die Zusammenfassungsdaten relativ zum Teilergebnis ein.
Kann einer der folgenden XlSummaryRow-Werte sein:
xlSummaryAbove
xlSummaryBelow (Standardwert)

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 das Teilergebnis für einen NamedRange erstellt. Das Teilergebnis ist die Summe aller drei Felder in dem NamedRange.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    Private Sub CreateSubtotal()
        Me.Range("A1").Value2 = "Row 1"
        Me.Range("B1").Value2 = "Row 2"
        Me.Range("C1").Value2 = "Row 3"

        Me.Range("A2", "A5").Value2 = 10
        Me.Range("B2", "B5").Value2 = 20
        Me.Range("C2", "C5").Value2 = 30

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "C5"), _
            "namedRange1")

        Dim fields() As Integer = {1, 2, 3}
        namedRange1.Subtotal(1, Excel.XlConsolidationFunction.xlSum, _
            fields, , , Excel.XlSummaryRow.xlSummaryBelow)
    End Sub

private void CreateSubtotal()
{
    this.Range["A1", missing].Value2 = "Row 1";
    this.Range["B1", missing].Value2 = "Row 2";
    this.Range["C1", missing].Value2 = "Row 3";

    this.Range["A2", "A5"].Value2 = 10;
    this.Range["B2", "B5"].Value2 = 20;
    this.Range["C2", "C5"].Value2 = 30;

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "C5"],
        "namedRange1");

    int[] fields = new int[] { 1, 2, 3 };
    namedRange1.Subtotal(1, Excel.XlConsolidationFunction.xlSum,
        fields, missing, missing, Excel.XlSummaryRow.xlSummaryBelow);
}

.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