Range.Sort Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сортирует отчет сводной таблицы, диапазон или активную область, если указанный диапазон содержит только одну ячейку.
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);
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
Необязательный параметр XlSortOrder. Порядок сортировки для поля или диапазона, указанных в Key1
. Может быть одной из следующих констант XlSortOrder :xlDescending. Сортировка Key1
по убыванию.xlAscendingdefault
. Сортировка Key1
по возрастанию.
- Key2
- Object
Необязательный объект. Второе поле сортировки в виде текста (поле сводной таблицы или имя диапазона) или объекта Range . Если опустить этот аргумент, то второе поле сортировки не будет. Не может использоваться при сортировке отчетов сводной таблицы.
- Type
- Object
Необязательный объект. Указывает, какие элементы следует отсортировать. Используйте этот аргумент только при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlSortType :xlSortLabels. Сортирует отчет сводной таблицы по меткам. xlSortValues. Сортирует отчет сводной таблицы по значениям.
- Order2
- XlSortOrder
Необязательный параметр XlSortOrder. Порядок сортировки для поля или диапазона, указанных в Key2
. Не может использоваться при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlSortOrder :xlDescending. Сортировка Key2
по убыванию.xlAscendingdefault
. Сортировка Key2
по возрастанию.
- Key3
- Object
Необязательный объект. Третье поле сортировки в виде текста (имя диапазона) или объекта Range . Если этот аргумент не указан, третье поле сортировки отсутствует. Не может использоваться при сортировке отчетов сводной таблицы.
- Order3
- XlSortOrder
Необязательный параметр XlSortOrder. Порядок сортировки для поля или диапазона, указанных в Key3
. Не может использоваться при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlSortOrder :xlDescending. Сортировка Key3
по убыванию.xlAscendingdefault
. Сортировка Key3
по возрастанию.
- Header
- XlYesNoGuess
Необязательный параметр XlYesNoGuess. Указывает, содержит ли первая строка заголовки. Не может использоваться при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlYesNoGuess :xlGuess. Дайте Microsoft Excel определить, есть ли заголовок, и определите, где он находится, если он есть. xlNodefault
. (Весь диапазон должен быть отсортирован). xlYes. (Весь диапазон не должен быть отсортирован).
- OrderCustom
- Object
Необязательный объект. Этот аргумент представляет собой одночисленное смещение в списке настраиваемых заказов сортировки. Если опустить OrderCustom
, используется обычная сортировка.
- MatchCase
- Object
Необязательный объект. Значение True для сортировки с учетом регистра; Значение False для сортировки без учета регистра. Не может использоваться при сортировке отчетов сводной таблицы.
- Orientation
- XlSortOrientation
Необязательный параметр XlSortOrientation. Ориентация сортировки. Может быть одной из следующих констант XlSortOrientation :xlSortRowsdefault
. Сортировка по строкам. xlSortColumns. Сортировка по столбцам.
- SortMethod
- XlSortMethod
Необязательный параметр XlSortMethod. Тип сортировки. Некоторые из этих констант могут быть недоступны в зависимости от выбранной или установленной языковой поддержки (например, английский язык США). Может быть одной из следующих констант XlSortMethod :xlStroke Sorting по количеству штрихов в каждом символе. xlPinYindefault
. Порядок сортировки символов на фонетическом китайском языке.
- DataOption1
- XlSortDataOption
Необязательный параметр XlSortDataOption. Указывает способ сортировки текста в Key 1
. Не может использоваться при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlSortDataOption :xlSortTextAsNumbers. Обрабатывать текст как числовые данные для сортировки. xlSortNormaldefault
. Сортирует числовые и текстовые данные отдельно.
- DataOption2
- XlSortDataOption
Необязательный параметр XlSortDataOption. Указывает способ сортировки текста в Key 2
. Не может использоваться при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlSortDataOption :xlSortTextAsNumbers. Обрабатывает текст как числовые данные для сортировки. xlSortNormaldefault
. Сортирует числовые и текстовые данные отдельно.
- DataOption3
- XlSortDataOption
Необязательный параметр XlSortDataOption. Указывает способ сортировки текста в ключе 3. Не может использоваться при сортировке отчетов сводной таблицы. Может быть одной из следующих констант XlSortDataOption :xlSortTextAsNumbers. Обрабатывает текст как числовые данные для сортировки. xlSortNormaldefault
. Сортирует числовые и текстовые данные отдельно.
Возвращаемое значение
Комментарии
Параметры для Header
, Order1
, Order2
, Order3
, OrderCustom
и Orientation
сохраняются для конкретного листа при каждом использовании этого метода. Если не указать значения для этих аргументов при следующем вызове метода, будут использоваться сохраненные значения. Задайте эти аргументы явным образом при каждом использовании метода Sort , если вы решили не использовать сохраненные значения.
Текстовые строки, которые не могут быть преобразованы в числовые данные, сортируются нормально.
Если с помощью метода Sort аргументы не определены, Microsoft Excel сортирует выбранный для сортировки выбор по возрастанию.