Método WorksheetBase.PivotTableWizard

  • Artigo

Cria um objeto de 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 para o novo relatório.Pode ser um objeto de 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 que contêm a cadeia de caracteres de consulta SQL, onde cada elemento até 255 caracteres de comprimento.Você deve usar o argumento de 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 de dados ODBC.O segundo elemento é a cadeia de caracteres 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 intervalo de SourceData , você deve especificar TableDestination também.
  • tableDestination
    Tipo: System.Object
    Um objeto de Range que especifica onde o relatório deve ser colocado na planilha.Se esse argumento é omitido, o relatório é colocado na célula ativo.
  • rowGrand
    Tipo: System.Object
    true gerais para mostrar total de linhas no relatório.
  • columnGrand
    Tipo: System.Object
    true para mostrar total gerais para colunas no relatório.
  • saveData
    Tipo: System.Object
    true para salvar dados com o relatório; false para salvar somente a definição de relatório.
  • hasAutoFormat
    Tipo: System.Object
    true para o formato Microsoft Office Excel automaticamente quando o relatório é atualizado ou quando os campos são movidos.
  • autoPage
    Tipo: System.Object
    Válido somente se SourceType é xlConsolidation. true para que o excel criar um campo de página para a consolidação.Se AutoPage é false, você deve criar o campo ou campos de página.
  • backgroundQuery
    Tipo: System.Object
    true para que o excel executar consultas de forma assíncrona para o relatório (no plano de fundo).O valor padrão é false.
  • optimizeCache
    Tipo: System.Object
    true para otimizar o cache de Tabela Dinâmica quando é construído.O valor padrão é false.
  • pageFieldWrapCount
    Tipo: System.Object
    O número de página coloca 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; este cache pode ser muito grande.Se ReadData é false, você pode definir alguns dos campos quantos a página com base em coloca antes que os dados sejam lidos de fato.
  • connection
    Tipo: System.Object
    Uma cadeia de caracteres que contém as configurações de conexão ODBC que permitem que o excel se conectem a uma fonte de dados ODBC.A cadeia de conexão tiver o formulário “; ODBC<connection string>”.Esse argumento substitui qualquer configuração anterior para a propriedade de Connection do objeto de 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 de Add para adicionar um cache de Tabela Dinâmica, e crie um relatório de 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 a seguir 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 de A1 ao C4 a planilha atual.

Este exemplo é para uma personalização da nível.

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