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", 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);
}

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.

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms