NamedRange.Sort Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Excel

Сборка:: Microsoft.Office.Tools.Excel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Сортирует данные в элементе управления 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. Сортирует числовые и текстовые данные отдельно.

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

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

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

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

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

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

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

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

Share via