NamedRange.Subtotal Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Excel

Сборка:

Microsoft.Office.Tools.Excel.dll

Создает промежуточные итоги для элемента управления NamedRange.

public object Subtotal (int GroupBy, Microsoft.Office.Interop.Excel.XlConsolidationFunction Function, object TotalList, object Replace, object PageBreaks, Microsoft.Office.Interop.Excel.XlSummaryRow SummaryBelowData = Microsoft.Office.Interop.Excel.XlSummaryRow.xlSummaryBelow);

abstract member Subtotal : int * Microsoft.Office.Interop.Excel.XlConsolidationFunction * obj * obj * obj * Microsoft.Office.Interop.Excel.XlSummaryRow -> obj

Public Function Subtotal (GroupBy As Integer, Function As XlConsolidationFunction, TotalList As Object, Optional Replace As Object, Optional PageBreaks As Object, Optional SummaryBelowData As XlSummaryRow = Microsoft.Office.Interop.Excel.XlSummaryRow.xlSummaryBelow) As Object

Параметры

GroupBy

Int32

Поле, по которому производится группирование, как целочисленное смещение от единицы.

Function

XlConsolidationFunction

Функция промежуточных итогов. Может иметь одно из следующих XlConsolidationFunction значений: xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlUnknownxlVarxlVarP

TotalList

Object

Массив смещения полей, отсчитываемого от единицы, указывающий поля, к которым добавляются промежуточные итоги.

Replace

Object

Значение true для замены существующих промежуточных итогов. Значение по умолчанию — false.

PageBreaks

Object

Значение true для добавления разрыва страницы после каждой группы. Значение по умолчанию — false.

SummaryBelowData

XlSummaryRow

Places сводные данные относительно промежуточных итогов. Может иметь одно из следующих XlSummaryRow значений: xlSummaryAbovexlSummaryBelow (по умолчанию)

Возвращаемое значение

Object

Примеры

В следующем примере кода создаются промежуточные итоги для NamedRange. Промежуточные итоги — это сумма всех трех полей в NamedRange.

Этот пример предназначен для настройки на уровне документа.

private void CreateSubtotal()
{
    this.Range["A1"].Value2 = "Row 1";
    this.Range["B1"].Value2 = "Row 2";
    this.Range["C1"].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, Excel.XlSummaryRow.xlSummaryBelow);
}

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

Комментарии

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.