NamedRange.Subtotal (Método)

Crea subtotales para el control NamedRange.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
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
)

Parámetros

• GroupBy
  Tipo: System.Int32
  Campo por el que se realizará la agrupación, como desplazamiento entero basado en uno.

• Function
  Tipo: Microsoft.Office.Interop.Excel.XlConsolidationFunction
  Función de subtotal.
  Puede ser uno de los siguientes valores de XlConsolidationFunction:
  xlAverage
  xlCount
  xlCountNums
  xlMax
  xlMin
  xlProduct
  xlStDev
  xlStDevP
  xlSum
  xlUnknown
  xlVar
  xlVarP

• TotalList
  Tipo: System.Object
  Matriz de desplazamientos de campo basados en uno, que indica los campos a los que se agregan los subtotales.

• Replace
  Tipo: System.Object
  Es true para reemplazar los subtotales existentes.El valor predeterminado es false.

• PageBreaks
  Tipo: System.Object
  Es true para agregar saltos de página detrás de cada grupo.El valor predeterminado es false.

• SummaryBelowData
  Tipo: Microsoft.Office.Interop.Excel.XlSummaryRow
  Coloca los datos de resumen relativos al subtotal.
  Puede ser uno de los siguientes valores de XlSummaryRow:
  xlSummaryAbove
  xlSummaryBelow (valor predeterminado)

Valor devuelto

Tipo: System.Object

Comentarios

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

En el ejemplo de código siguiente se crean subtotales para un NamedRange.Los subtotales son la suma de los tres campos de NamedRange.

Se trata de un ejemplo para una personalización en el nivel del 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);
}

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

NamedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)