Workbook.PivotTableWizard Метод (2007 System)
Обновлен: Ноябрь 2007
Создает объект Microsoft.Office.Interop.Excel.PivotTable.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)
Синтаксис
'Декларация
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 _
)
'Применение
Dim instance As Workbook
Dim SourceType As Object
Dim SourceData As Object
Dim TableDestination As Object
Dim TableName As Object
Dim RowGrand As Object
Dim ColumnGrand As Object
Dim SaveData As Object
Dim HasAutoFormat As Object
Dim AutoPage As Object
Dim Reserved As Object
Dim BackgroundQuery As Object
Dim OptimizeCache As Object
Dim PageFieldOrder As Object
Dim PageFieldWrapCount As Object
Dim ReadData As Object
Dim Connection As Object
instance.PivotTableWizard(SourceType, _
SourceData, TableDestination, TableName, _
RowGrand, ColumnGrand, SaveData, _
HasAutoFormat, AutoPage, Reserved, _
BackgroundQuery, OptimizeCache, _
PageFieldOrder, PageFieldWrapCount, _
ReadData, Connection)
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
)
Параметры
- SourceType
Тип: System.Object
Значение XlPivotTableSourceType. Источник данных для отчета.
- 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.
Заметки
Этот метод не выполняет отображение мастера сводных таблиц. Этот метод недоступен для источников данных OLE DB. Для добавления кэша сводной таблицы вызывается метод Add, затем необходимо создать отчет сводной таблицы на основе этого кэша.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.
Примеры
В следующем примере кода метод PivotTableWizard вызывается для создания отчета сводной таблицы в листе Sheet2 на основе диапазона ячеек A1–C4 в листе Sheet1.
В этом примере демонстрируется настройка уровня документа.
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", missing].Value2 = "Date";
Globals.Sheet1.Range["A2", missing].Value2 = "March 1";
Globals.Sheet1.Range["A3", missing].Value2 = "March 8";
Globals.Sheet1.Range["A4", missing].Value2 = "March 15";
Globals.Sheet1.Range["B1", missing].Value2 = "Customer";
Globals.Sheet1.Range["B2", missing].Value2 = "Smith";
Globals.Sheet1.Range["B3", missing].Value2 = "Jones";
Globals.Sheet1.Range["B4", missing].Value2 = "James";
Globals.Sheet1.Range["C1", missing].Value2 = "Sales";
Globals.Sheet1.Range["C2", missing].Value2 = "23";
Globals.Sheet1.Range["C3", missing].Value2 = "17";
Globals.Sheet1.Range["C4", missing].Value2 = "39";
this.PivotTableWizard(
Excel.XlPivotTableSourceType.xlDatabase,
Globals.Sheet1.Range["A1", "C4"],
Globals.Sheet2.Range["A1", missing], "PivotTable1",
false, false, true, false, missing, missing,
false, false, Excel.XlOrder.xlDownThenOver, missing,
missing, missing);
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.