Поделиться через


WorksheetBase.PivotTableWizard - метод

Создает объект Microsoft.Office.Interop.Excel.PivotTable.

Пространство имен:  Microsoft.Office.Tools.Excel
Сборка:  Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Синтаксис

'Декларация
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
)

Параметры

  • sourceData
    Тип: System.Object
    Данные для нового отчета.Может являться объектом Range, массивом диапазонов или текстовой константой, которые представляют имя другого отчета.Для внешней базы данных параметр SourceData является массивом строк, содержащим строку запроса SQL, длина каждого элемента которого не превышает 255 символов.Для указания строки подключения ODBC необходимо использовать аргумент Connection.Кроме того, в целях совместимости с предыдущими версиями Excel параметр SourceData может являться массивом, состоящим из двух элементов.Первый элемент — это строка подключения, указывающая на источник ODBC для данных.Второй элемент — строка запроса SQL, используемая для получения данных.При указании параметра SourceData необходимо также указать параметр SourceType.Если активная ячейка находится внутри диапазона SourceData, необходимо также указать параметр TableDestination.
  • tableDestination
    Тип: System.Object
    Объект Range, указывающий место размещения отчета на листе.Если этот аргумент опущен, отчет помещается в активную ячейку.
  • tableName
    Тип: System.Object
    Имя нового отчета.
  • rowGrand
    Тип: System.Object
    Значение true, чтобы отображать общие итоги для строк в отчете.
  • columnGrand
    Тип: System.Object
    Значение true, чтобы отображать общие итоги для столбцов в отчете.
  • saveData
    Тип: System.Object
    Значение true, чтобы сохранять данные в отчете; значение false, чтобы сохранять только определение отчета.
  • hasAutoFormat
    Тип: System.Object
    Значение true, чтобы задать выполнение Microsoft Office Excel автоматического форматирования отчета при его обновлении или при перемещении полей.
  • autoPage
    Тип: System.Object
    Допустимо, только если SourceType равняется xlConsolidation.Значение true, чтобы приложение Excel создавало поле страницы для консолидации.Если параметр AutoPage имеет значение false, необходимо создать поле или поля страницы самостоятельно.
  • reserved
    Тип: System.Object
    Не используется Excel.
  • backgroundQuery
    Тип: System.Object
    Значение true, чтобы задать асинхронное выполнение запросов для отчета (в фоновом режиме) средствами Excel.Значение по умолчанию — false.
  • optimizeCache
    Тип: System.Object
    Значение true, чтобы оптимизировать кэш сводной таблицы при построении.Значение по умолчанию — false.
  • pageFieldOrder
    Тип: System.Object
    Порядок добавления полей страниц в макет отчета сводной таблицы.Может принимать значение одной из следующих констант метода XlOrder: xlDownThenOver или xlOverThenDown.Значение по умолчанию — xlDownThenOver.
  • pageFieldWrapCount
    Тип: System.Object
    Количество полей страницы в каждом столбце или строке в отчете сводной таблицы.Значение по умолчанию равно 0 (нулю).
  • readData
    Тип: System.Object
    Значение true, чтобы создать кэш сводной таблицы, содержащий все записи из внешних баз данных; этот кэш может быть очень большим.Если параметр ReadData имеет значение false, можно задать несколько полей в качестве полей страниц на сервере перед фактическим считыванием данных.
  • connection
    Тип: System.Object
    Строка, содержащая параметры ODBC, которые позволяют Excel подключаться к источнику данных ODBC.Строка подключения имеет вид «ODBC;<строка_подключения>».Этот аргумент предопределяет любую предыдущую установку объекта PivotCache свойства Connection.

Возвращаемое значение

Тип: Microsoft.Office.Interop.Excel.PivotTable
Объект Microsoft.Office.Interop.Excel.PivotTable.

Заметки

Этот метод не выполняет отображение мастера сводных таблиц. Этот метод недоступен для источников данных OLE DB. Для добавления кэша сводной таблицы вызывается метод Add, затем необходимо создать отчет сводной таблицы на основе этого кэша.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода метод PivotTableWizard вызывается для создания отчета сводной таблицы на основе содержимого диапазона ячеек A1–C4 текущего листа.

В этом примере демонстрируется настройка уровня документа.

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

Безопасность платформы .NET Framework

См. также

Ссылки

WorksheetBase Класс

Microsoft.Office.Tools.Excel - пространство имен