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
以一維整數位移的形式,建立欄位群組。
- 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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。