NamedRange.SortSpecial - метод

Статья
08/11/2011

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

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)

Синтаксис

'Декларация
Function SortSpecial ( _
    SortMethod As XlSortMethod, _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Type As Object, _
    Key2 As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object SortSpecial(
    XlSortMethod SortMethod,
    Object Key1,
    XlSortOrder Order1,
    Object Type,
    Object Key2,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

Параметры

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

Key1
Тип: System.Object
Первое поле сортировки как текст (имя диапазона) или объект Microsoft.Office.Interop.Excel.Range (например «Dept» или Cells(1, 1)).

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

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

Key2
Тип: System.Object
Второе поле сортировки как текст (имя диапазона) или объект Microsoft.Office.Interop.Excel.Range.Если этот аргумент не задан, второе поле сортировки отсутствует.Не может использоваться при сортировке отчетов сводных таблиц.

Order2
Тип: Microsoft.Office.Interop.Excel.XlSortOrder
Порядок сортировки для поля или диапазона, указанного в аргументе Key2.Не может использоваться при сортировке отчетов сводных таблиц.
Может быть одно из следующих значений XlSortOrder:
xlDescending.Выполняет сортировку Key2 по убыванию.
xlAscending (по умолчанию).Выполняет сортировку Key2 по возрастанию.

Key3
Тип: System.Object
Третье поле сортировки как текст (имя диапазона) или объект Microsoft.Office.Interop.Excel.Range.Если этот аргумент не задан, третье поле сортировки отсутствует.Не может использоваться при сортировке отчетов сводных таблиц.

Order3
Тип: Microsoft.Office.Interop.Excel.XlSortOrder
Порядок сортировки для поля или диапазона, указанного в аргументе Key3.Не может использоваться при сортировке отчетов сводных таблиц.
Может быть одно из следующих значений XlSortOrder:
xlDescending.Выполняет сортировку Key3 по убыванию.
xlAscending (по умолчанию).Выполняет сортировку Key3 по возрастанию.

Header
Тип: Microsoft.Office.Interop.Excel.XlYesNoGuess
Определяет, содержит ли первая строка заголовки.Не может использоваться при сортировке отчетов сводных таблиц.
Может быть одно из следующих значений XlYesNoGuess:
xlGuess.Позволяет приложению Microsoft Office Excel определять наличие заголовка и место, где он находится.
xlNo (по умолчанию).Требуется сортировка всего диапазона.
xlYes.Сортировка всего диапазона не требуется.

OrderCustom
Тип: System.Object
Данный аргумент представляет собой отсчитываемое от единицы целочисленное смещение списка пользовательских порядков сортировки.Если OrderCustom не задан, используется обычный порядок сортировки.

MatchCase
Тип: System.Object
Значение true для выполнения сортировки с учетом регистра; значение false для выполнения сортировки без учета регистра.Не может использоваться при сортировке отчетов сводных таблиц.

Orientation
Тип: Microsoft.Office.Interop.Excel.XlSortOrientation
Ориентация сортировки.
Может быть одно из следующих значений XlSortOrientation:
xlSortRows (по умолчанию).Сортировка выполняется по строкам.
xlSortColumns.Сортировка выполняется по столбцам.

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

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

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

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

Тип: System.Object

Заметки

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

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

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

Примеры

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

В этом примере демонстрируется настройка уровня документа.

    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

private void SortSpecialNamedRange()
{
    this.Range["A1", missing].Value2 = 50;
    this.Range["A2", missing].Value2 = 10;
    this.Range["A3", missing].Value2 = 20;
    this.Range["A4", missing].Value2 = 30;
    this.Range["A5", missing].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);
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

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