Compartilhar via

Método WorksheetBase.PivotTableWizard

  • Artigo

Cria um objeto Microsoft.Office.Interop.Excel.PivotTable.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
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
    Os dados do novo relatório.Podem ser um objeto Range, uma matriz de intervalos ou uma constante de texto que representa o nome de outro relatório.Para um banco de dados externo, SourceData é uma matriz de cadeias de caracteres contendo a cadeia de caracteres de consulta SQL, em que cada elemento tem até 255 caracteres.Você deve usar o argumento Connection para especificar a cadeia de conexão ODBC.Para compatibilidade com versões anteriores do Excel, SourceData pode ser uma matriz de dois elementos.O primeiro elemento é a cadeia de conexão que especifica a fonte ODBC dos dados.O segundo elemento é a cadeia de caracteres de consulta SQL usada para obter os dados.Caso especifique SourceData, você também deve especificar SourceType.Caso a célula ativa esteja dentro do intervalo SourceData, você deve especificar TableDestination também.
  • tableDestination
    Tipo: System.Object
    Um objeto Range que especifica onde o relatório deve ser colocado na planilha.Caso esse argumento seja omitido, o relatório é colocado na célula ativa.
  • rowGrand
    Tipo: System.Object
    true para mostrar total gerais de linhas no relatório.
  • columnGrand
    Tipo: System.Object
    true para mostrar total gerais de colunas no relatório.
  • saveData
    Tipo: System.Object
    true para salvar dados com o relatório; false para salvar apenas a definição do relatório.
  • hasAutoFormat
    Tipo: System.Object
    true para o Microsoft Office Excel formatar automaticamente o relatório quando ele é atualizado ou quando os campos são movidos.
  • autoPage
    Tipo: System.Object
    Válido somente se SourceType for xlConsolidation.true para o Excel criar um campo de página para a consolidação.Caso AutoPage seja false, você deve criar o campo ou os campos da página.
  • backgroundQuery
    Tipo: System.Object
    true para o Excel executar consultas do o relatório forma assíncrona (no plano de fundo).O valor padrão é false.
  • optimizeCache
    Tipo: System.Object
    true para otimizar o cache da Tabela Dinâmica quando ele é construído.O valor padrão é false.
  • pageFieldWrapCount
    Tipo: System.Object
    O número de campos de página em cada coluna ou linha do relatório de Tabela Dinâmica.O valor padrão é 0 (zero).
  • readData
    Tipo: System.Object
    true para criar um cache da Tabela Dinâmica que contenha todos os registros do banco de dados externo; esse cache pode ser muito grande.Caso ReadData seja false, você pode definir alguns dos campos como campos de página com base no servidor antes dos dados serem efetivamente lidos.
  • connection
    Tipo: System.Object
    Uma cadeia de caracteres que contém configurações ODBC que permitem que o Excel se conecte com uma fonte de dados ODBC.A cadeia de conexão tem a forma "ODBC;<connection string>".Esse argumento substitui qualquer configuração anterior para a propriedade Connection do objeto PivotCache.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.PivotTable
O objeto Microsoft.Office.Interop.Excel.PivotTable.

Comentários

Este método não exibe o Assistente de Tabela Dinâmica. Este método não está disponível para fontes de dados OLE DB. Use o método Add para adicionar um cache da Tabela Dinâmica e, em seguida, criar um relatório da Tabela Dinâmica com base no cache.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código usa o método de PivotTableWizard para criar um relatório de tabela dinâmica com base no conteúdo do intervalo das células da A1 C4 a planilha atual.

Este exemplo destina-se a uma personalização no nível de 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);
}

Segurança do .NET Framework

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel