WorkbookBase.PivotTableWizard (Método)
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 Sub 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 _
)
public void 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
- sourceType
Tipo: System.Object
Valor XlPivotTableSourceType.El origen de los datos del informe.
- 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.
- tableName
Tipo: System.Object
Nombre del nuevo informe.
- 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.
- reserved
Tipo: System.Object
No utilizado por Excel.
- 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.
- pageFieldOrder
Tipo: System.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
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.
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 en Sheet2 basado en el rango de celdas de A1 a C4 en Sheet1.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub CreatePivotTable()
Globals.Sheet1.Range("A1").Value2 = "Date"
Globals.Sheet1.Range("A2").Value2 = "March 1"
Globals.Sheet1.Range("A3").Value2 = "March 8"
Globals.Sheet1.Range("A4").Value2 = "March 15"
Globals.Sheet1.Range("B1").Value2 = "Customer"
Globals.Sheet1.Range("B2").Value2 = "Smith"
Globals.Sheet1.Range("B3").Value2 = "Jones"
Globals.Sheet1.Range("B4").Value2 = "James"
Globals.Sheet1.Range("C1").Value2 = "Sales"
Globals.Sheet1.Range("C2").Value2 = "23"
Globals.Sheet1.Range("C3").Value2 = "17"
Globals.Sheet1.Range("C4").Value2 = "39"
Me.PivotTableWizard(Excel.XlPivotTableSourceType.xlDatabase, _
Globals.Sheet1.Range("A1", "C4"), _
Globals.Sheet2.Range("A1", System.Type.Missing), "PivotTable1", _
False, False, True, False, backgroundQuery:=False, _
optimizeCache:=False, pageFieldOrder:=Excel.XlOrder.xlDownThenOver)
End Sub
private void CreatePivotTable()
{
Globals.Sheet1.Range["A1"].Value2 = "Date";
Globals.Sheet1.Range["A2"].Value2 = "March 1";
Globals.Sheet1.Range["A3"].Value2 = "March 8";
Globals.Sheet1.Range["A4"].Value2 = "March 15";
Globals.Sheet1.Range["B1"].Value2 = "Customer";
Globals.Sheet1.Range["B2"].Value2 = "Smith";
Globals.Sheet1.Range["B3"].Value2 = "Jones";
Globals.Sheet1.Range["B4"].Value2 = "James";
Globals.Sheet1.Range["C1"].Value2 = "Sales";
Globals.Sheet1.Range["C2"].Value2 = "23";
Globals.Sheet1.Range["C3"].Value2 = "17";
Globals.Sheet1.Range["C4"].Value2 = "39";
this.PivotTableWizard(
Excel.XlPivotTableSourceType.xlDatabase,
Globals.Sheet1.Range["A1", "C4"],
Globals.Sheet2.Range["A1"], "PivotTable1",
false, false, true, false,
false, false, Excel.XlOrder.xlDownThenOver);
}
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.