NamedRange.Sort 메서드

참조

정의

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

어셈블리:: Microsoft.Office.Tools.Excel.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

public object Sort (object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key2, object Type, Microsoft.Office.Interop.Excel.XlSortOrder Order2 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key3, Microsoft.Office.Interop.Excel.XlSortOrder Order3 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Microsoft.Office.Interop.Excel.XlYesNoGuess Header = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlNo, object OrderCustom, object MatchCase, Microsoft.Office.Interop.Excel.XlSortOrientation Orientation = Microsoft.Office.Interop.Excel.XlSortOrientation.xlSortRows, Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption1 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption2 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption3 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal);

abstract member Sort : obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * Microsoft.Office.Interop.Excel.XlSortOrder * Microsoft.Office.Interop.Excel.XlYesNoGuess * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrientation * Microsoft.Office.Interop.Excel.XlSortMethod * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function Sort (Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key2 As Object, Optional Type As Object, Optional Order2 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key3 As Object, Optional Order3 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Header As XlYesNoGuess = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlNo, Optional OrderCustom As Object, Optional MatchCase As Object, Optional Orientation As XlSortOrientation = Microsoft.Office.Interop.Excel.XlSortOrientation.xlSortRows, Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional DataOption1 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Optional DataOption2 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Optional DataOption3 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal) As Object

매개 변수

Key1: Object

텍스트(범위 이름) 또는 개체("부서" 또는 Range Cells(1, 1))와 같은 첫 번째 정렬 필드입니다.

Order1: XlSortOrder

에 지정된 필드 또는 범위에 대한 정렬 순서입니다 Key1. 다음 XlSortOrder 값 xlDescending중 하나일 수 있습니다. 내림차순으로 정렬 Key1 합니다. xlAscending. 오름차순으로 정렬 Key1 합니다.

Key2: Object

텍스트(범위 이름) 또는 Range 개체인 두 번째 정렬 필드입니다. 이 인수를 생략하면 두 번째 정렬 필드가 없습니다.

Type: Object

정렬할 요소를 지정합니다. 피벗 테이블 보고서를 정렬할 때만 이 인수를 사용합니다. 다음 XlSortType 값 xlSortLabels중 하나일 수 있습니다. 레이블을 기준으로 피벗 테이블 보고서를 정렬합니다. xlSortValues. 값을 기준으로 피벗 테이블 보고서를 정렬합니다.

Order2: XlSortOrder

에 지정된 범위의 정렬 순서입니다 Key2. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다. 다음 XlSortOrder 값 xlDescending중 하나일 수 있습니다. 내림차순으로 정렬 Key2 합니다. xlAscending. 오름차순으로 정렬 Key2 합니다.

Key3: Object

텍스트(범위 이름) 또는 Range 개체인 세 번째 정렬 필드입니다. 이 인수를 생략하면 세 번째 정렬 필드가 없습니다. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다.

Order3: XlSortOrder

에 지정된 필드 또는 범위에 대한 정렬 순서입니다 Key3. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다. 다음 XlSortOrder 값 xlDescending중 하나일 수 있습니다. 내림차순으로 정렬 Key3 합니다. xlAscending. 오름차순으로 정렬 Key3 합니다.

Header: XlYesNoGuess

첫 번째 행에 머리글이 포함되는지 여부를 지정합니다. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다. 다음 XlYesNoGuess 값 xlGuess중 하나일 수 있습니다. Microsoft Office Excel에서 머리글이 있는지 여부를 확인하고 머리글이 있으면 위치를 확인하게 합니다. xlNo. 전체 범위가 정렬되어야 합니다. xlYes. 전체 범위가 정렬되면 안 됩니다.

OrderCustom: Object

이 인수는 사용자 지정 정렬 순서 목록에 대한 1부터 시작하는 정수 오프셋입니다. 를 생략 OrderCustom하면 일반 정렬이 사용됩니다.

MatchCase: Object

대/소문자를 구분하여 정렬하려면 true이고, 대/소문자를 구분하지 않고 정렬하려면 false입니다. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다.

Orientation: XlSortOrientation

정렬 방향입니다. 다음 XlSortOrientation 값 xlSortRows중 하나일 수 있습니다. 행을 기준으로 정렬합니다. xlSortColumns. 열을 기준으로 정렬합니다.

SortMethod: XlSortMethod

정렬 형식입니다. 이러한 상수 중 일부는 선택하거나 설치한 언어 지원(예: 미국 영어)에 따라 제공되지 않을 수 있습니다. 다음 XlSortMethod 값 xlStroke중 하나일 수 있습니다. 각 문자의 입력 수를 기준으로 정렬합니다. xlPinYin. 문자에 대한 표음 중국어 정렬 순서입니다.

DataOption1: XlSortDataOption

에서 key1텍스트를 정렬하는 방법을 지정합니다. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다. 다음 XlSortDataOption 값 xlSortTextAsNumbers중 하나일 수 있습니다. 정렬하기 위해 텍스트를 숫자 데이터로 처리합니다. xlSortNormal. 숫자 데이터와 텍스트 데이터를 따로 정렬합니다.

DataOption2: XlSortDataOption

에서 key2텍스트를 정렬하는 방법을 지정합니다. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다. 다음 XlSortDataOption 값 xlSortTextAsNumbers중 하나일 수 있습니다. 정렬하기 위해 텍스트를 숫자 데이터로 처리합니다. xlSortNormal. 숫자 데이터와 텍스트 데이터를 따로 정렬합니다.

DataOption3: XlSortDataOption

에서 key3텍스트를 정렬하는 방법을 지정합니다. 피벗 테이블 보고서를 정렬할 때 사용할 수 없습니다. 다음 XlSortDataOption 값 xlSortTextAsNumbers중 하나일 수 있습니다. 정렬하기 위해 텍스트를 숫자 데이터로 처리합니다. xlSortNormal. 숫자 데이터와 텍스트 데이터를 따로 정렬합니다.

반환

Object

예제

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

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

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);
}

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

설명

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

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

이 메서드로 정의된 인수가 없으면 Microsoft Office Excel에서 선택 항목을 오름차순으로 정렬합니다.

선택적 매개 변수

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

적용 대상

다음을 통해 공유

NamedRange.Sort 메서드

정의

매개 변수

반환

예제

설명

선택적 매개 변수

적용 대상

추가 리소스