NamedRange.SortSpecial Метод

Ссылка

Определение

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

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

Важно!

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

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

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

Object

Примеры

В следующем примере кода метод используется для сортировки SortSpecial NamedRange с помощью пин-кода Инь (фонетический порядок сортировки символов на китайском языке). Для сортировки китайских символов в этом примере предполагается, что у пользователя есть поддержка китайского языка для 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

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

Share via

NamedRange.SortSpecial Метод

Определение

Параметры

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

Примеры

Комментарии

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

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

Дополнительные ресурсы