NamedRange.Subtotal 方法
为 NamedRange 控件创建小计。
命名空间: Microsoft.Office.Tools.Excel
程序集: Microsoft.Office.Tools.Excel(在 Microsoft.Office.Tools.Excel.dll 中)
语法
声明
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
)
参数
- GroupBy
类型:System.Int32
要作为分组依据的字段,是从 1 开始的整数偏移量。
- Function
类型:Microsoft.Office.Interop.Excel.XlConsolidationFunction
小计函数。
可以为以下 XlConsolidationFunction 值之一:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlUnknown
xlVar
xlVarP
- TotalList
类型:System.Object
一个从 1 开始的字段偏移量数组,指示要将小计添加到的字段。
- Replace
类型:System.Object
如果替换现有的小计,则为 true。默认值为 false。
- PageBreaks
类型:System.Object
如果在每组后面添加分页符,则为 true。默认值为 false。
- SummaryBelowData
类型:Microsoft.Office.Interop.Excel.XlSummaryRow
放置与小计相关的摘要数据。
可以是下列 XlSummaryRow 值之一:
xlSummaryAbove
xlSummaryBelow(默认值)
返回值
备注
可选参数
有关可选参数的信息,请参见Office 解决方案中的可选参数。
示例
下面的代码示例为 NamedRange 创建小计。 小计是 NamedRange 中全部三个字段的和。
此示例针对的是文档级自定义项。
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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。