Share via


NamedRange.SortSpecial 메서드

동아시아 정렬 방법을 사용하여 NamedRange 컨트롤을 정렬합니다.예를 들어 일본어는 가나 음절 순서로 정렬합니다.자세한 내용은 매개 변수 목록을 참조하십시오.

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

구문

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

매개 변수

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

반환 값

형식: System.Object

설명

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

선택적 매개 변수

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

예제

다음 코드 예제에서는 SortSpecial 메서드를 사용하여 Pin Yin(문자에 대한 표음 중국어 정렬 순서)을 통해 NamedRange를 정렬합니다.이 예제에서는 사용자에게 중국어 문자를 정렬하기 위한 Microsoft Office Excel용 중국어 지원 기능이 있다고 가정합니다.사용자에게 중국어 지원 기능이 없는 경우에는 Excel에서 기본적으로 값을 기준으로 NamedRange를 정렬합니다.

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

    Private Sub SortSpecialNamedRange()
        Me.Range("A1").Value2 = 50
        Me.Range("A2").Value2 = 10
        Me.Range("A3").Value2 = 20
        Me.Range("A4").Value2 = 30
        Me.Range("A5").Value2 = 40

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin, _
            Me.Range("A1", "A5"), Excel.XlSortOrder.xlAscending, , , _
            Excel.XlSortOrder.xlAscending, , _
            Excel.XlSortOrder.xlAscending, _
            Excel.XlYesNoGuess.xlNo, , , _
            Excel.XlSortOrientation.xlSortColumns, _
            Excel.XlSortDataOption.xlSortNormal, _
            Excel.XlSortDataOption.xlSortNormal, _
            Excel.XlSortDataOption.xlSortNormal)
    End Sub

private void SortSpecialNamedRange()
{
    this.Range["A1"].Value2 = 50;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 30;
    this.Range["A5"].Value2 = 40;

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin,
        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.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);

}

.NET Framework 보안

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

참고 항목

참조

NamedRange 인터페이스

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