WorksheetBase.PivotTableWizard Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Excel

Ensamblado:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea un objeto PivotTable.

public Microsoft.Office.Interop.Excel.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);

member this.PivotTableWizard : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> Microsoft.Office.Interop.Excel.PivotTable

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

Parámetros

sourceType: Object

Valor XlPivotTableSourceType. El origen de los datos del informe.

sourceData: 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. Para una base de datos externa, SourceData es una matriz de cadenas que contienen la cadena de consulta SQL, donde cada elemento tiene una longitud de hasta 255 caracteres. Debe usar el Connection argumento para especificar el 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 SourceData intervalo, también debe especificar TableDestination .

tableDestination: 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.

tableName: Object

Nombre del nuevo informe.

rowGrand: Object

true para mostrar los totales generales de las filas del informe.

columnGrand: Object

true para mostrar los totales generales de las columnas del informe.

saveData: Object

true para guardar datos con el informe; false para guardar sólo la definición de informe.

hasAutoFormat: Object

true para que Microsoft Office Excel dé formato automáticamente al informe cuando se actualiza o cuando se desplazan campos.

autoPage: Object

Válido solo 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.

reserved: Object

No utilizado por Excel.

backgroundQuery: Object

true para que Excel realice las consultas del informe de forma asincrónica (en segundo plano). El valor predeterminado es false.

optimizeCache: Object

true para optimizar la caché de la tabla dinámica cuando se crea. El valor predeterminado es false.

pageFieldOrder: Object

El orden en que se agregan los campos de página en el diseño del informe de tabla dinámica. Puede ser una de las constantes XlOrder siguientes: xlDownThenOver o xlOverThenDown. El valor predeterminado es xlDownThenOver.

pageFieldWrapCount: 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: 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 de los campos como campos de página basados en servidor antes de que los datos se lean realmente.

connection: 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 PivotCache del objeto Connection.

Devoluciones

PivotTable

Objeto PivotTable.

Ejemplos

En el ejemplo de código siguiente se usa el PivotTableWizard método 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.

Este ejemplo es para una personalización de nivel de documento.

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

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

Comentarios

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

Parámetros opcionales

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

Se aplica a

Compartir a través de