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


WorksheetBase.PivotTableWizard Метод

Определение

Создает объект PivotTable.

public Microsoft.Office.Interop.Excel.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);
member this.PivotTableWizard : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> Microsoft.Office.Interop.Excel.PivotTable
Public Function PivotTableWizard (Optional sourceType As Object, Optional sourceData As Object, Optional tableDestination As Object, Optional tableName As Object, Optional rowGrand As Object, Optional columnGrand As Object, Optional saveData As Object, Optional hasAutoFormat As Object, Optional autoPage As Object, Optional reserved As Object, Optional backgroundQuery As Object, Optional optimizeCache As Object, Optional pageFieldOrder As Object, Optional pageFieldWrapCount As Object, Optional readData As Object, Optional connection As Object) As PivotTable

Параметры

sourceType
Object

Значение XlPivotTableSourceType. Источник данных для отчета.

sourceData
Object

Данные для нового отчета. Может являться объектом Range, массивом диапазонов или текстовой константой, которые представляют имя другого отчета. Для внешней базы данных — это массив строк, SourceData содержащих строку ЗАПРОСА SQL, где каждый элемент имеет длину до 255 символов. Для указания строка подключения ODBC следует использовать Connection аргумент . Для совместимости с более ранними версиями Excel SourceData может быть двухэлейным массивом. Первый элемент — это строка подключения, указывающая на источник ODBC для данных. Второй элемент — строка запроса SQL, используемая для получения данных. При указании SourceData также необходимо указать SourceType. Если активная ячейка SourceData находится внутри диапазона, необходимо также указать TableDestination .

tableDestination
Object

Объект Range, указывающий место размещения отчета на листе. Если этот аргумент опущен, отчет помещается в активную ячейку.

tableName
Object

Имя нового отчета.

rowGrand
Object

Значение true, чтобы отображать общие итоги для строк в отчете.

columnGrand
Object

Значение true, чтобы отображать общие итоги для столбцов в отчете.

saveData
Object

Значение true, чтобы сохранять данные в отчете; значение false, чтобы сохранять только определение отчета.

hasAutoFormat
Object

Значение true, чтобы задать выполнение Microsoft Office Excel автоматического форматирования отчета при его обновлении или при перемещении полей.

autoPage
Object

Допустимо только в том случае, если SourceType имеет значение xlConsolidation. Значение true, чтобы приложение Excel создавало поле страницы для консолидации. Если AutoPage имеет значение false, необходимо создать поле страницы или поля.

reserved
Object

Не используется Excel.

backgroundQuery
Object

Значение true, чтобы задать асинхронное выполнение запросов для отчета (в фоновом режиме) средствами Excel. Значение по умолчанию — false.

optimizeCache
Object

Значение true, чтобы оптимизировать кэш сводной таблицы при построении. Значение по умолчанию — false.

pageFieldOrder
Object

Порядок добавления полей страниц в макет отчета сводной таблицы. Может быть одной из следующих констант XlOrder: xlDownThenOver или xlOverThenDown. Значение по умолчанию — xlDownThenOver.

pageFieldWrapCount
Object

Количество полей страницы в каждом столбце или строке в отчете сводной таблицы. Значение по умолчанию — 0 (нуль).

readData
Object

Значение true, чтобы создать кэш сводной таблицы, содержащий все записи из внешних баз данных; этот кэш может быть очень большим. Если ReadData имеет значение false, можно задать некоторые поля как серверные поля страницы до фактического считывания данных.

connection
Object

Строка, содержащая параметры ODBC, которые позволяют Excel подключаться к источнику данных ODBC. Строка подключения имеет вид "ODBC;<строка подключения>". Этот аргумент предопределяет любую предыдущую установку объекта PivotCache свойства Connection.

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

Объект PivotTable.

Примеры

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

Этот пример предназначен для настройки на уровне документа.

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

Комментарии

Этот метод не отображает мастер сводной таблицы. Этот метод недоступен для источников данных OLE DB. Microsoft.Office.Interop.Excel.Worksheets.Add* Используйте метод , чтобы добавить кэш сводной таблицы, а затем создать отчет сводной таблицы на основе кэша.

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

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

Применяется к