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


NamedRange.SortSpecial Метод

Определение

Использует методы сортировки, предназначенные для восточноазиатских языков, для сортировки элемента управления NamedRange. Например, для японского языка сортировка выполняется в порядке японской азбуки. Дополнительные сведения см. в списке параметров.

public object SortSpecial (Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Type, object Key2, 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.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 SortSpecial : Microsoft.Office.Interop.Excel.XlSortMethod * 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.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj
Public Function SortSpecial (Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Type As Object, Optional Key2 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 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

Параметры

SortMethod
XlSortMethod

Тип сортировки. Некоторые из этих констант могут быть недоступны в зависимости от выбранной или установленной языковой поддержки (например, английский язык США). Может иметь одно из следующих XlSortMethod значений: xlStroke. Сортировка по количеству штрихов в каждом знаке. xlPinYin (по умолчанию). Порядок сортировки для символов, основанный на фонетике китайского языка.

Key1
Object

Первое поле сортировки в виде текста (имя диапазона) или Range объекта (например, "Dept" или Cells(1, 1).

Order1
XlSortOrder

Порядок сортировки для поля или диапазона, указанного в Key1. Может иметь одно из следующих XlSortOrder значений: xlDescending. Сортирует по Key1 убыванию. xlAscending (по умолчанию). Сортирует Key1 по возрастанию.

Type
Object

Задает сортируемые элементы. Используйте этот аргумент только при сортировке отчетов сводных таблиц.

Key2
Object

Второе поле сортировки как текст (имя диапазона) или объект Range. Если этот аргумент не задан, второе поле сортировки отсутствует. Не может использоваться при сортировке отчетов сводных таблиц.

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. Сортировка выполняется по столбцам.

DataOption1
XlSortDataOption

Указывает способ сортировки текста в key1. Не может использоваться при сортировке отчетов сводной таблицы. Может иметь одно из следующих XlSortDataOption значений: xlSortTextAsNumbers. Обрабатывает текст как числовые данные для сортировки. xlSortNormal (по умолчанию). Сортирует числовые и текстовые данные отдельно.

DataOption2
XlSortDataOption

Указывает способ сортировки текста в key2. Не может использоваться при сортировке отчетов сводной таблицы. Может иметь одно из следующих XlSortDataOption значений: xlSortTextAsNumbers. Обрабатывает текст как числовые данные для сортировки. xlSortNormal (по умолчанию). Сортирует числовые и текстовые данные отдельно.

DataOption3
XlSortDataOption

Указывает способ сортировки текста в key3. Не может использоваться при сортировке отчетов сводной таблицы. Может иметь одно из следующих XlSortDataOption значений: xlSortTextAsNumbers. Обрабатывает текст как числовые данные для сортировки. xlSortNormal (по умолчанию). Сортирует числовые и текстовые данные отдельно.

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

Примеры

В следующем примере кода метод используется для сортировки SortSpecialNamedRange с помощью пин-кода Инь (фонетический порядок сортировки символов на китайском языке). Для сортировки китайских символов в этом примере предполагается, что у пользователя есть поддержка китайского языка для Microsoft Office Excel. Excel по умолчанию сортирует по значению NamedRange , если у пользователя нет поддержки китайского языка.

Этот пример предназначен для настройки на уровне документа.

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

}
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

Комментарии

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

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

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

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