Metodo NamedRange.Subtotal

Articolo
05/17/2013

Crea subtotali per il controllo NamedRange.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
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
)

Parametri

GroupBy
Tipo: System.Int32
Campo in base al quale eseguire il raggruppamento, come offset di Integer in base uno.

Function
Tipo: Microsoft.Office.Interop.Excel.XlConsolidationFunction
Funzione di subtotale.
Può essere uno dei seguenti valori di XlConsolidationFunction:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlUnknown
xlVar
xlVarP

TotalList
Tipo: System.Object
Matrice di offset di campo in base uno, che indica i campi ai quali vengono aggiunti i subtotali.

Replace
Tipo: System.Object
true per sostituire i subtotali esistenti.Il valore predefinito è false.

PageBreaks
Tipo: System.Object
true per aggiungere un'interruzione di pagina dopo ciascun gruppo.Il valore predefinito è false.

SummaryBelowData
Tipo: Microsoft.Office.Interop.Excel.XlSummaryRow
Posiziona i dati di riepilogo relativi al subtotale.
Può essere uno dei seguenti valori di XlSummaryRow:
xlSummaryAbove
xlSummaryBelow (impostazione predefinita)

Valore restituito

Tipo: System.Object

Note

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito vengono creati i subtotali per un controllo NamedRange.I subtotali corrispondono alla somma di tutti e tre i campi del controllo NamedRange.

Questo esempio è valido per una personalizzazione a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite