Partilhar via

Método WorksheetBase.PivotTableWizard

  • Artigo

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

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 para o novo relatório.Pode ser um Range objeto, 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 seqüências de caracteres que contém a seqüência de caracteres de consulta SQL, onde cada elemento é até 255 caracteres de comprimento.Você deve usar o Connection argumento para especificar a seqüência de caracteres de conexão ODBC.Para compatibilidade com versões anteriores do Excel, SourceData pode ser uma matriz de dois elementos.O primeiro elemento é a seqüência de conexão que especifica a fonte ODBC para os dados.O segundo elemento é a seqüência de consulta SQL usada para obter os dados.Se você especificar SourceData, você também deve especificar SourceType.Se a célula ativa está dentro do SourceData o intervalo, você deve especificar TableDestination como bem.
  • tableDestination
    Tipo: System.Object
    A Range objeto especificando onde o relatório deve ser colocado na planilha.Se esse argumento for omitido, o relatório será colocado na célula ativa.
  • rowGrand
    Tipo: System.Object
    true para mostrar os totais para linhas no relatório.
  • columnGrand
    Tipo: System.Object
    true para mostrar os totais para colunas no relatório.
  • saveData
    Tipo: System.Object
    true Para salvar os dados com o relatório; falsePara salvar a definição de relatório.
  • hasAutoFormat
    Tipo: System.Object
    true Microsoft Office de ter o Excel formatar automaticamente o relatório quando ele for atualizado ou quando os campos são movidos.
  • autoPage
    Tipo: System.Object
    Válido somente se SourceType é xlConsolidation.truepara que o Excel cria um campo de página para a consolidação.Se AutoPage é false, você deve criar o campo de página ou campos.
  • backgroundQuery
    Tipo: System.Object
    true para que o Excel executar consultas para o relatório de forma assíncrona (em segundo plano).O valor padrão é false.
  • optimizeCache
    Tipo: System.Object
    true para otimizar o cache de tabela dinâmica quando ela é construída.O valor padrão é false.
  • pageFieldWrapCount
    Tipo: System.Object
    O número de campos de página em cada coluna ou linha no relatório de tabela dinâmica.O valor padrão é 0 (zero).
  • readData
    Tipo: System.Object
    true para criar um cache de tabela dinâmica que contém todos os registros do banco de dados externo; Esse cache pode ser muito grande.Se ReadData é false, você pode definir alguns dos campos como campos de página baseada em servidor antes que os dados são, na verdade, a leitura.
  • connection
    Tipo: System.Object
    Uma seqüência de caracteres que contém as configurações de ODBC que permitem ao Excel para se conectar a uma fonte de dados ODBC.A seqüência de conexão tem o formulário "ODBC; < seqüência de conexão >".Este argumento sobrescreve qualquer definição anterior para o PivotCache do objeto Connection propriedade.

Valor de retorno

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

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 Add método para adicionar um cache de tabela dinâmica e, em seguida, criar um relatório de tabela dinâmica baseado no cache.

Optional Parameters

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

Exemplos

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

Este exemplo é para uma personalização em 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", missing].Value2 = "Date";
    this.Range["A2", missing].Value2 = "March 1";
    this.Range["A3", missing].Value2 = "March 8";
    this.Range["A4", missing].Value2 = "March 15";

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

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

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

Segurança do .NET Framework

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel