Compartir a través de

WorksheetBase.PivotTableWizard (Método)

  • Artículo

Crea un objeto Microsoft.Office.Interop.Excel.PivotTable.

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

Sintaxis

'Declaración
Public Function PivotTableWizard ( _
    sourceType As Object, _
    sourceData As Object, _
    tableDestination As Object, _
    tableName As Object, _
    rowGrand As Object, _
    columnGrand As Object, _
    saveData As Object, _
    hasAutoFormat As Object, _
    autoPage As Object, _
    reserved As Object, _
    backgroundQuery As Object, _
    optimizeCache As Object, _
    pageFieldOrder As Object, _
    pageFieldWrapCount As Object, _
    readData As Object, _
    connection As Object _
) As PivotTable

public PivotTable PivotTableWizard(
    Object sourceType,
    Object sourceData,
    Object tableDestination,
    Object tableName,
    Object rowGrand,
    Object columnGrand,
    Object saveData,
    Object hasAutoFormat,
    Object autoPage,
    Object reserved,
    Object backgroundQuery,
    Object optimizeCache,
    Object pageFieldOrder,
    Object pageFieldWrapCount,
    Object readData,
    Object connection
)

Parámetros

  • sourceData
    Tipo: System.Object
    Los datos para el nuevo informe.Puede ser un objeto Range, una matriz de rangos o una constante de texto que representa el nombre de otro informe.En una base de datos externa, SourceData es una matriz de cadenas que contiene la cadena de la consulta SQL, donde cada elemento tiene una longitud máxima de 255 caracteres.Debe utilizar el argumento Connection para especificar la cadena de conexión ODBC.Para la compatibilidad con versiones anteriores de Excel, SourceData puede ser una matriz de dos elementos.El primer elemento es la cadena de conexión que especifica el origen de ODBC de los datos.El segundo elemento es la cadena de la consulta SQL utilizada para obtener los datos.Si especifica SourceData, también debe especificar SourceType.Si la celda activa está dentro del rango de SourceData, también debe especificar TableDestination.
  • tableDestination
    Tipo: System.Object
    Un objeto Range que especifica dónde se debe colocar el informe en la hoja de cálculo.Si se omite este argumento, el informe se coloca en la celda activa.
  • rowGrand
    Tipo: System.Object
    true para mostrar los totales generales de las filas del informe.
  • columnGrand
    Tipo: System.Object
    true para mostrar los totales generales de las columnas del informe.
  • saveData
    Tipo: System.Object
    true para guardar datos con el informe; false para guardar sólo la definición de informe.
  • hasAutoFormat
    Tipo: System.Object
    true para que Microsoft Office Excel dé formato automáticamente al informe cuando se actualiza o cuando se desplazan campos.
  • autoPage
    Tipo: System.Object
    Válido sólo si SourceType es xlConsolidation. true para que Excel cree un campo de página para la consolidación.Si AutoPage es false, debe crear el campo o los campos de página.
  • backgroundQuery
    Tipo: System.Object
    true para que Excel realice las consultas del informe de forma asincrónica (en segundo plano).El valor predeterminado es false.
  • optimizeCache
    Tipo: System.Object
    true para optimizar la caché de la tabla dinámica cuando se crea.El valor predeterminado es false.
  • pageFieldWrapCount
    Tipo: System.Object
    El número de campos de página en cada columna o fila del informe de tabla dinámica.El valor predeterminado es 0 (cero).
  • readData
    Tipo: System.Object
    true para crear una caché de tabla dinámica que contenga todos los registros de la base de datos externa; esta caché puede ser muy grande.Si ReadData es false, puede establecer algunos campos como campos de página basados en servidor antes de que se lean los datos.
  • connection
    Tipo: System.Object
    Una cadena que contiene la configuración ODBC que permite a Excel conectarse a un origen de datos ODBC.La cadena de conexión tiene el formato "ODBC;<cadena de conexión>".Este argumento reemplaza cualquier configuración anterior de la propiedad Connection del objeto PivotCache.

Valor devuelto

Tipo: Microsoft.Office.Interop.Excel.PivotTable
Objeto Microsoft.Office.Interop.Excel.PivotTable.

Comentarios

Este método no muestra el Asistente para tablas dinámicas.Este método no está disponible para los orígenes de datos OLE DB.Utilice el método Add para agregar una caché de tabla dinámica y, a continuación, cree un informe de tabla dinámica basado en la caché.

Parámetros opcionales

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

Ejemplos

El ejemplo de código siguiente usa el método PivotTableWizard para crear un informe de tabla dinámica basado en el contenido del rango de celdas de A1 a C4 de la hoja de cálculo actual.

Se trata de un ejemplo para una personalización en el nivel del documento.

Private Sub CreatePivotTable()
    Me.Range("A1").Value2 = "Date"
    Me.Range("A2").Value2 = "March 1"
    Me.Range("A3").Value2 = "March 8"
    Me.Range("A4").Value2 = "March 15"

    Me.Range("B1").Value2 = "Customer"
    Me.Range("B2").Value2 = "Smith"
    Me.Range("B3").Value2 = "Jones"
    Me.Range("B4").Value2 = "James"

    Me.Range("C1").Value2 = "Sales"
    Me.Range("C2").Value2 = "23"
    Me.Range("C3").Value2 = "17"
    Me.Range("C4").Value2 = "39"

    Dim table1 As Excel.PivotTable = _
        Me.PivotTableWizard(Excel.XlPivotTableSourceType.xlDatabase, _
            Me.Range("A1", "C4"), TableName:="PivotTable1", RowGrand:=False, _
            ColumnGrand:=False, SaveData:=True, HasAutoFormat:=False, _
            PageFieldOrder:=Excel.XlOrder.xlDownThenOver)
End Sub

private void CreatePivotTable()
{  
    this.Range["A1"].Value2 = "Date";
    this.Range["A2"].Value2 = "March 1";
    this.Range["A3"].Value2 = "March 8";
    this.Range["A4"].Value2 = "March 15";

    this.Range["B1"].Value2 = "Customer";
    this.Range["B2"].Value2 = "Smith";
    this.Range["B3"].Value2 = "Jones";
    this.Range["B4"].Value2 = "James";

    this.Range["C1"].Value2 = "Sales";
    this.Range["C2"].Value2 = "23";
    this.Range["C3"].Value2 = "17";
    this.Range["C4"].Value2 = "39";

    Excel.PivotTable table1 = this.PivotTableWizard(
        Excel.XlPivotTableSourceType.xlDatabase, this.Range["A1", "C4"],
        "PivotTable1", false, false, true, false, false, false, Excel.XlOrder.xlDownThenOver);
}

Seguridad de .NET Framework

Vea también

Referencia

WorksheetBase Clase

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