다음을 통해 공유

NamedRange.Sort 메서드

  • 아티클

NamedRange 컨트롤의 데이터를 정렬합니다.

네임스페이스:  Microsoft.Office.Tools.Excel
어셈블리:  Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
Function Sort ( _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Key2 As Object, _
    Type As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    SortMethod As XlSortMethod, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object Sort(
    Object Key1,
    XlSortOrder Order1,
    Object Key2,
    Object Type,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortMethod SortMethod,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

매개 변수

  • Type
    형식: System.Object
    정렬할 요소를 지정합니다.피벗 테이블 보고서를 정렬할 때만 이 인수를 사용합니다.
    다음 XlSortType 값 중 하나일 수 있습니다.
    xlSortLabels .레이블을 기준으로 피벗 테이블 보고서를 정렬합니다.
    xlSortValues .값을 기준으로 피벗 테이블 보고서를 정렬합니다.
  • Key3
    형식: System.Object
    텍스트(범위 이름) 또는 Microsoft.Office.Interop.Excel.Range 개체인 세 번째 정렬 필드입니다.이 인수를 생략하면 세 번째 정렬 필드가 없습니다.피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다.
  • Header
    형식: Microsoft.Office.Interop.Excel.XlYesNoGuess
    첫 번째 행에 머리글이 포함되는지 여부를 지정합니다.피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다.
    다음 XlYesNoGuess 값 중 하나일 수 있습니다.
    xlGuess .Microsoft Office Excel에서 머리글이 있는지 여부를 확인하고 머리글이 있으면 위치를 확인하게 합니다.
    xlNo .전체 범위가 정렬되어야 합니다.
    xlYes .전체 범위가 정렬되면 안 됩니다.
  • OrderCustom
    형식: System.Object
    이 인수는 사용자 지정 정렬 순서 목록에 대한 1부터 시작하는 정수 오프셋입니다. OrderCustom을 생략하면 일반 정렬이 사용됩니다.
  • MatchCase
    형식: System.Object
    대/소문자를 구분하여 정렬하려면 true이고, 대/소문자를 구분하지 않고 정렬하려면 false입니다.피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다.
  • SortMethod
    형식: Microsoft.Office.Interop.Excel.XlSortMethod
    정렬 형식입니다.선택 또는 설치한 지원 언어(예.:. 미국의 경우 영어)에 따라 위에 나열된 상수 중 일부를 사용하지 못할 수도 있습니다.
    다음 XlSortMethod 값 중 하나일 수 있습니다.
    xlStroke .각 문자의 입력 수를 기준으로 정렬합니다.
    xlPinYin .문자에 대한 표음 중국어 정렬 순서입니다.

반환 값

형식: System.Object

설명

Header, Order1, Order2, Order3, OrderCustom 및 Orientation에 대한 설정은 이 메서드를 사용할 때마다 특정 워크시트에 대해 저장됩니다.다음에 메서드를 호출할 때 이러한 인수의 값을 지정하지 않으면 저장된 값이 사용됩니다.저장된 값을 사용하지 않도록 선택하면 이 메서드를 사용할 때마다 이 인수를 명시적으로 설정해야 합니다.

숫자 데이터로 변환할 수 없는 텍스트 문자열은 정상적으로 정렬됩니다.

이 메서드에 인수가 정의되어 있지 않으면 Microsoft Office Excel에서 선택 영역을 오름차순으로 정렬합니다.

선택적 매개 변수

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

예제

다음 코드 예제에서는 셀 A1부터 A5까지에 정수 집합을 배치한 다음 Sort 메서드를 사용하여 데이터를 오름차순으로 정렬합니다.

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

    Private Sub SortNamedRange()
        ' Set some data in a range of cells.
        Me.Range("A1").Value2 = 30
        Me.Range("A2").Value2 = 10
        Me.Range("A3").Value2 = 20
        Me.Range("A4").Value2 = 50
        Me.Range("A5").Value2 = 40

        ' Create a NamedRange that refers to the range.
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        ' Sort the NamedRange.
        namedRange1.Sort(Me.Range("A1", "A5"), _
            Excel.XlSortOrder.xlAscending, , , _
            Excel.XlSortOrder.xlAscending, , _
            Excel.XlSortOrder.xlAscending, Excel.XlYesNoGuess.xlNo, , , _
            Excel.XlSortOrientation.xlSortColumns, _
            Excel.XlSortMethod.xlStroke, _
            Excel.XlSortDataOption.xlSortNormal, _
            Excel.XlSortDataOption.xlSortNormal, _
            Excel.XlSortDataOption.xlSortNormal)
    End Sub


private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].Value2 = 40;

    // Create a NamedRange that refers to the range.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Sort the NamedRange.
    namedRange1.Sort(this.Range["A1", "A5"],
        Excel.XlSortOrder.xlAscending,
        missing,
        missing,
        Excel.XlSortOrder.xlAscending,
        missing,
        Excel.XlSortOrder.xlAscending,
        Excel.XlYesNoGuess.xlNo,
        missing,
        missing,
        Excel.XlSortOrientation.xlSortColumns,
        Excel.XlSortMethod.xlStroke,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);
}

.NET Framework 보안

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

참고 항목

참조

NamedRange 인터페이스

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