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 を 2 要素の配列にすることができます。最初の要素は、データの ODBC ソースを指定する接続文字列です。2 番目の要素は、データの取得に使用する 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
  更新されたとき、またはフィールドが移動されたときに Microsoft Office Excel がレポートを自動で書式設定する場合は true です。

• autoPage
  型 : System.Object
  SourceType が xlConsolidation の場合のみ有効です。Excel が、統合のためにページ フィールドを作成する場合は true。 AutoPage が false の場合、ページ フィールドを 1 つ以上作成する必要があります。

• reserved
  型 : System.Object
  Excel では使用しません。

• backgroundQuery
  型 : System.Object
  Excel が非同期 (バックグラウンド) でレポートにクエリを実行する場合は true です。既定値 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
  Excel が ODBC データ ソースに接続するための ODBC 設定を含む文字列です。接続文字列は、"ODBC;<connection string>" という形式です。この引数は、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"].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 セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

WorksheetBase クラス

Microsoft.Office.Tools.Excel 名前空間