WorksheetBase.PivotTableWizard Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Excel

Сборка:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Создает объект 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

Объект 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.

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

Share via