Freigeben über

WorksheetBase.PivotTableWizard-Methode

  • Artikel

Erstellt ein Microsoft.Office.Interop.Excel.PivotTable-Objekt.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
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
)

Parameter

  • sourceData
    Typ: System.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 SourceData ein Array von Zeichenfolgen, das die SQL-Abfragezeichenfolge enthält, wobei jedes Element eine maximale Länge von 255 Zeichen hat.Die ODBC-Verbindungszeichenfolge sollten Sie mithilfe des Connection-Arguments angeben.Aus Gründen der Kompatibilität mit früheren Versionen von Excel kann SourceData ein aus zwei Elementen bestehendes Array 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.Wenn Sie SourceData angeben, müssen Sie auch SourceType angeben.Falls die aktive Zelle sich im SourceData-Bereich befindet, müssen Sie außerdem TableDestination angeben.
  • tableDestination
    Typ: System.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.
  • rowGrand
    Typ: System.Object
    true , wenn im Bericht das Gesamtergebnis für Zeilen angezeigt werden soll.
  • columnGrand
    Typ: System.Object
    true , wenn im Bericht das Gesamtergebnis für Spalten angezeigt werden soll.
  • saveData
    Typ: System.Object
    true , wenn die Daten mit dem Bericht gespeichert werden sollen, false, um nur die Berichtsdefinition zu speichern.
  • hasAutoFormat
    Typ: System.Object
    true , damit Microsoft Office Excel den Bericht automatisch formatiert, wenn dieser aktualisiert wird oder wenn Felder verschoben werden.
  • autoPage
    Typ: System.Object
    Nur gültig, wenn SourceType gleich xlConsolidation ist. true , wenn Excel ein Seitenfeld für die Konsolidierung erstellen soll.Wenn AutoPage gleich false ist, müssen Sie das Seitenfeld oder die Seitenfelder erstellen.
  • backgroundQuery
    Typ: System.Object
    true , damit Excel Abfragen für den Bericht asynchron (im Hintergrund) ausführt.Der Standardwert ist false.
  • optimizeCache
    Typ: System.Object
    true , um den PivotTable-Cache zu optimieren, wenn er erstellt wird.Der Standardwert ist false.
  • pageFieldWrapCount
    Typ: System.Object
    Die Anzahl von Seitenfeldern in jeder Spalte oder Zeile im PivotTable-Bericht.Der Standardwert ist 0 (null).
  • readData
    Typ: System.Object
    true , um einen PivotTable-Cache zu erstellen, der alle Datensätze aus der externen Datenbank enthält. Dieser Cache kann sehr groß sein.Wenn ReadData gleich false ist, können Sie einige Felder als serverbasierte Seitenfelder festlegen, bevor die Daten gelesen werden.
  • connection
    Typ: System.Object
    Eine Zeichenfolge, die ODBC-Einstellungen enthält, mit deren Hilfe Excel eine Verbindung zu einer ODBC-Datenquelle herstellen kann.Die Verbindungszeichenfolge weist das Format "ODBC;<Verbindungszeichenfolge>" auf.Dieses Argument überschreibt alle vorherigen Einstellungen für die Connection-Eigenschaft des PivotCache-Objekts.

Rückgabewert

Typ: Microsoft.Office.Interop.Excel.PivotTable
Das Microsoft.Office.Interop.Excel.PivotTable-Objekt.

Hinweise

Diese Methode zeigt nicht den PivotTable-Assistenten an.Diese Methode ist für OLE DB-Datenquellen nicht verfügbar.Fügen Sie mithilfe der Add-Methode einen PivotTable-Cache hinzu, und erstellen Sie einen PivotTable-Bericht auf der Grundlage des Caches.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

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

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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"].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);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

WorksheetBase Klasse

Microsoft.Office.Tools.Excel-Namespace