NamedRange.SortSpecial Метод (2007 System)

Обновлен: Ноябрь 2007

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

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

Синтаксис

'Декларация
Public 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
'Применение
Dim instance As NamedRange
Dim SortMethod As XlSortMethod
Dim Key1 As Object
Dim Order1 As XlSortOrder
Dim Type As Object
Dim Key2 As Object
Dim Order2 As XlSortOrder
Dim Key3 As Object
Dim Order3 As XlSortOrder
Dim Header As XlYesNoGuess
Dim OrderCustom As Object
Dim MatchCase As Object
Dim Orientation As XlSortOrientation
Dim DataOption1 As XlSortDataOption
Dim DataOption2 As XlSortDataOption
Dim DataOption3 As XlSortDataOption
Dim returnValue As Object

returnValue = instance.SortSpecial(SortMethod, _
    Key1, Order1, Type, Key2, Order2, Key3, _
    Order3, Header, OrderCustom, MatchCase, _
    Orientation, DataOption1, DataOption2, _
    DataOption3)

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

Разрешения

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

См. также

Ссылки

NamedRange Класс

NamedRange - члены

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