Поделиться через


NamedRange.Sort Метод

Определение

Сортирует данные в элементе управления 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 объекта (например, "Dept" или 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

Данный аргумент представляет собой отсчитываемое от единицы целочисленное смещение списка пользовательских порядков сортировки. Если опустить 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. Сортирует числовые и текстовые данные отдельно.

Возвращаемое значение

Примеры

В следующем примере кода набор целых чисел помещает в ячейки 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

Комментарии

Параметры для Header, Order1, Order2, Order3, OrderCustomи Orientation сохраняются для конкретного листа при каждом использовании этого метода. Если вы не укажете значения для этих аргументов при следующем вызове метода, будут использоваться сохраненные значения. Задайте эти аргументы явным образом при каждом использовании этого метода, если вы решили не использовать сохраненные значения.

Текстовые строки, которые не могут быть преобразованы в числовые данные, сортируются в обычном режиме.

Если с помощью этого метода не определены аргументы, Microsoft Office Excel отсортирует выбор в порядке возрастания.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Применяется к