NamedRange.Group(Object, Object, Object, Object) 메서드

정의

네임스페이스:

Microsoft.Office.Tools.Excel

어셈블리:

Microsoft.Office.Tools.Excel.dll

NamedRange 컨트롤이 피벗 테이블 필드의 데이터 범위에 있는 단일 셀을 나타내는 경우 Group(Object, Object, Object, Object) 메서드는 해당 필드에서 숫자 또는 날짜 기반 그룹화를 수행합니다.

public object Group (object Start, object End, object By, object Periods);

abstract member Group : obj * obj * obj * obj -> obj

Public Function Group (Optional Start As Object, Optional End As Object, Optional By As Object, Optional Periods As Object) As Object

매개 변수

Start

Object

그룹화될 첫째 값입니다. 이 인수를 생략하거나 이 인수가 true이면 필드의 첫째 값을 사용합니다.

End

Object

그룹화될 마지막 값입니다. 이 인수를 생략하거나 이 인수가 true이면 필드의 마지막 값을 사용합니다.

By

Object

필드가 숫자이면 이 인수는 각 그룹의 크기를 지정합니다. 필드가 날짜인 경우 이 인수는 배열 true 의 요소 4 Periods 가 이고 다른 모든 요소가 인 경우 각 그룹의 일 수를 지정합니다false. 그렇지 않으면 이 인수는 무시됩니다. 이 인수를 생략하면 Microsoft Office Excel에서 자동으로 기본 그룹 크기를 선택합니다.

Periods

Object

다음과 같이 그룹에 대한 기간을 지정하는 7개의 부울 값 배열입니다.1 - Seconds2 - Minutes3 - Hours4 - Days5 - Months6 - Quarters7 - Years 배열의 true요소가 이면 해당 시간 동안 그룹이 만들어집니다. 요소가 false이면 그룹이 만들어지지 않습니다. 필드가 날짜 필드가 아니면 이 인수는 무시됩니다.

반환

Object

예제

다음 코드 예제에서는 피벗 테이블 보고서와 NamedRange 피벗 테이블 보고서의 영역 내에 를 만듭니다. 그런 다음 , , , 및 PivotField 속성을 사용하여 PivotTable피벗 테이블 보고서 내에서 의 NamedRange 배치에 대한 정보를 표시합니다. PivotItemPivotCellLocationInTable 이 예제에서는 메서드를 Group 사용하여 필드의 첫 번째 값을 기반으로 숫자 그룹화도 수행합니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

private void DisplayPivotTableInformation()
{
    // Specify values for the PivotTable.
    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";

    // Create and populate the PivotTable.
    Excel.PivotTable table1 = this.PivotTableWizard(
        Excel.XlPivotTableSourceType.xlDatabase,
        this.Range["A1", "C4"],
        this.Range["A10"], "Sales Table", false,
        false, true, false, false, false,
        Excel.XlOrder.xlDownThenOver);

    Excel.PivotField customerField =
        (Excel.PivotField)table1.PivotFields("Customer");
    customerField.Orientation =
        Excel.XlPivotFieldOrientation.xlRowField;
    customerField.Position = 1;

    Excel.PivotField dateField =
        (Excel.PivotField)table1.PivotFields("Date");
    dateField.Orientation =
        Excel.XlPivotFieldOrientation.xlColumnField;
    dateField.Position = 1;

    table1.AddDataField(table1.PivotFields("Sales"),
        "Sales Summary", Excel.XlConsolidationFunction.xlSum);

    // Create a NamedRange in the PivotTable and display the 
    // location.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(
        this.Range["B11"], "namedRange1");
    namedRange1.Select();

    MessageBox.Show("The NamedRange is in the PivotTable report '" +
        namedRange1.PivotTable.Name + "' at the location '" +
        namedRange1.LocationInTable.ToString() + "'.");

    MessageBox.Show("The NamedRange has a PivotCell type of: " +
         namedRange1.PivotCell.PivotCellType.ToString());

    MessageBox.Show("The NamedRange is in the PivotTable field: " +
         namedRange1.PivotField.Name);

    MessageBox.Show("The NamedRange is in the PivotTable item: " +
        namedRange1.PivotItem.Name);

    namedRange1.Group(true);
}

Private Sub DisplayPivotTableInformation()
    ' Specify values for the PivotTable.
    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"

    ' Create and populate the PivotTable.
    Dim table1 As Excel.PivotTable = _
        Me.PivotTableWizard( _
        Excel.XlPivotTableSourceType.xlDatabase, _
        Me.Range("A1", "C4"), Me.Range("A10"), "Sales Table", _
        False, False, True, False, , , False, False, _
        Excel.XlOrder.xlDownThenOver, , , )

    Dim customerField As Excel.PivotField = _
        CType(table1.PivotFields("Customer"), Excel.PivotField)
    customerField.Orientation = _
        Excel.XlPivotFieldOrientation.xlRowField
    customerField.Position = 1

    Dim dateField As Excel.PivotField = _
        CType(table1.PivotFields("Date"), Excel.PivotField)
    dateField.Orientation = _
        Excel.XlPivotFieldOrientation.xlColumnField
    dateField.Position = 1

    table1.AddDataField(table1.PivotFields("Sales"), _
        "Sales Summary", Excel.XlConsolidationFunction.xlSum)

    ' Create a NamedRange in the PivotTable and display the 
    ' location.
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("B11"), _
        "namedRange1")
    namedRange1.Select()

    MessageBox.Show("The NamedRange is in the PivotTable report '" & _
        namedRange1.PivotTable.Name & "' at the location '" & _
        namedRange1.LocationInTable.ToString() & "'.")

    MessageBox.Show("The NamedRange has a PivotCell type of: " & _
        namedRange1.PivotCell.PivotCellType.ToString())

    MessageBox.Show("The NamedRange is in the PivotTable field: " & _
        namedRange1.PivotField.Name)

    MessageBox.Show("The NamedRange is in the PivotTable item: " & _
        namedRange1.PivotItem.Name)

    namedRange1.Group(True, , , )
End Sub

설명

컨트롤은 NamedRange 피벗 테이블 필드의 데이터 범위에 있는 단일 셀이어야 합니다. 이 메서드를 둘 이상의 셀에 적용하려고 하면 오류 메시지를 표시하지 않고 실패합니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하세요.