NamedRange.Subtotal, méthode
Crée des sous-totaux du contrôle NamedRange.
Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)
Syntaxe
'Déclaration
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
)
Paramètres
- GroupBy
Type : System.Int32
Champ à utiliser pour le regroupement, représentant un offset d'entier en base 1.
- Function
Type : Microsoft.Office.Interop.Excel.XlConsolidationFunction
Fonction de sous-total.
Il peut s'agir de l'une des valeurs de XlConsolidationFunction suivantes :
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlUnknown
xlVar
xlVarP
- TotalList
Type : System.Object
Tableau d'offsets de champ en base 1, indiquant les champs auxquels les sous-totaux sont ajoutés.
- Replace
Type : System.Object
true pour remplacer des sous-totaux existants.La valeur par défaut est false.
- PageBreaks
Type : System.Object
true pour ajouter des sauts de page après chaque groupe.La valeur par défaut est false.
- SummaryBelowData
Type : Microsoft.Office.Interop.Excel.XlSummaryRow
Place les données de synthèse relatives au sous-total.
Il peut s'agir de l'une des valeurs XlSummaryRow suivantes :
xlSummaryAbove
xlSummaryBelow (par défaut)
Valeur de retour
Type : System.Object
Notes
Paramètres optionnels
Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.
Exemples
L'exemple de code suivant crée des sous-totaux pour un NamedRange. Les sous-totaux sont la somme des trois champs de NamedRange.
Cet exemple illustre une personnalisation au niveau du document.
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"].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);
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.