WorksheetBase.PivotTableWizard 메서드

아티클
08/10/2011

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는 두 개의 요소로 구성된 배열일 수 있습니다.첫 번째 요소는 데이터의 ODBC 소스를 지정하는 연결 문자열입니다.두 번째 요소는 데이터를 가져오는 데 사용되는 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이면 페이지 필드를 만들어야 합니다.

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", missing].Value2 = "Date";
    this.Range["A2", missing].Value2 = "March 1";
    this.Range["A3", missing].Value2 = "March 8";
    this.Range["A4", missing].Value2 = "March 15";

    this.Range["B1", missing].Value2 = "Customer";
    this.Range["B2", missing].Value2 = "Smith";
    this.Range["B3", missing].Value2 = "Jones";
    this.Range["B4", missing].Value2 = "James";

    this.Range["C1", missing].Value2 = "Sales";
    this.Range["C2", missing].Value2 = "23";
    this.Range["C3", missing].Value2 = "17";
    this.Range["C4", missing].Value2 = "39";

    Excel.PivotTable table1 = this.PivotTableWizard(
        Excel.XlPivotTableSourceType.xlDatabase, this.Range["A1", "C4"],
        missing, "PivotTable1", false, false, true, false, missing,
        missing, false, false, Excel.XlOrder.xlDownThenOver, missing,
        missing, missing);
}

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

WorksheetBase 클래스

Microsoft.Office.Tools.Excel 네임스페이스

Share via