WorksheetBase.PivotTableWizard Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein PivotTable-Objekt.

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

Parameter

sourceType: Object

Ein XlPivotTableSourceType-Wert. Die Quelle der Berichtsdaten.

sourceData: Object

Die Daten für den neuen Bericht. Dabei kann es sich um ein Range-Objekt, ein Array von Bereichen oder eine Textkonstante, die den Namen eines anderen Berichts darstellt, handeln. Für eine externe Datenbank ist ein Array von Zeichenfolgen, SourceData das die SQL-Abfragezeichenfolge enthält, wobei jedes Element bis zu 255 Zeichen lang ist. Sie sollten das Connection Argument verwenden, um die ODBC-Verbindungszeichenfolge anzugeben. Aus Gründen der Kompatibilität mit früheren Versionen von Excel SourceData kann ein Array mit zwei Elementen sein. Das erste Element ist die Verbindungszeichenfolge, die die ODBC-Datenquelle angibt. Das zweite Element ist die SQL-Abfragezeichenfolge, die zum Abrufen der Daten verwendet wird. Bei Angabe von SourceData müssen Sie auch SourceType angeben. Wenn sich die aktive Zelle innerhalb des SourceData Bereichs befindet, müssen Sie ebenfalls angeben TableDestination .

tableDestination: Object

Ein Range-Objekt, das angibt, an welcher Stelle im Arbeitsblatt der Bericht platziert werden soll. Wenn dieses Argument ausgelassen wird, wird der Bericht in der aktiven Zelle platziert.

tableName: Object

Der Name des neuen Berichts.

rowGrand: Object

true, wenn im Bericht das Gesamtergebnis für Zeilen angezeigt werden soll.

columnGrand: Object

true, wenn im Bericht das Gesamtergebnis für Spalten angezeigt werden soll.

saveData: Object

true, wenn die Daten mit dem Bericht gespeichert werden sollen, false, um nur die Berichtsdefinition zu speichern.

hasAutoFormat: Object

true, damit Microsoft Office Excel den Bericht automatisch formatiert, wenn dieser aktualisiert wird oder wenn Felder verschoben werden.

autoPage: Object

Nur gültig, wenn SourceType ist xlConsolidation. true, wenn Excel ein Seitenfeld für die Konsolidierung erstellen soll. Wenn AutoPage ist false, müssen Sie das Seitenfeld oder die Felder erstellen.

reserved: Object

Wird von Excel nicht verwendet.

backgroundQuery: Object

true, damit Excel Abfragen für den Bericht asynchron (im Hintergrund) ausführt. Der Standardwert ist false.

optimizeCache: Object

true, um den PivotTable-Cache zu optimieren, wenn er erstellt wird. Der Standardwert ist false.

pageFieldOrder: Object

Die Reihenfolge, in der Seitenfelder dem Layout des PivotTable-Berichts hinzugefügt werden. Kann eine der folgenden XlOrder-Konstanten sein: xlDownThenOver oder xlOverThenDown. Der Standardwert ist xlDownThenOver.

pageFieldWrapCount: Object

Die Anzahl von Seitenfeldern in jeder Spalte oder Zeile im PivotTable-Bericht. Der Standardwert ist 0 (null).

readData: Object

true, um einen PivotTable-Cache zu erstellen, der alle Datensätze aus der externen Datenbank enthält. Dieser Cache kann sehr groß sein. falseWenn ReadData ist, können Sie einige felder als serverbasierte Seitenfelder festlegen, bevor die Daten tatsächlich gelesen werden.

connection: Object

Eine Zeichenfolge, die ODBC-Einstellungen enthält, mit deren Hilfe Excel eine Verbindung zu einer ODBC-Datenquelle herstellen kann. Die Verbindungszeichenfolge hat das Formular "ODBC;<Verbindungszeichenfolge>". Dieses Argument überschreibt alle vorherigen Einstellungen für die PivotCache-Eigenschaft des Connection-Objekts.

Gibt zurück

PivotTable

Das PivotTable-Objekt.

Beispiele

Im folgenden Codebeispiel wird die PivotTableWizard -Methode verwendet, um einen PivotTable-Bericht basierend auf dem Inhalt des Zellbereichs von A1 bis C4 des aktuellen Arbeitsblatts zu erstellen.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

Hinweise

Diese Methode zeigt den PivotTable-Assistenten nicht an. Diese Methode ist für OLE DB-Datenquellen nicht verfügbar. Verwenden Sie die Microsoft.Office.Interop.Excel.Worksheets.Add* -Methode, um einen PivotTable-Cache hinzuzufügen, und erstellen Sie dann basierend auf dem Cache einen PivotTable-Bericht.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über