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
)
Параметры
- 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.
Возвращаемое значение
Тип: 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
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.