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

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

Сортирует данные в элементе управления NamedRange.

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

Синтаксис

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

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

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

Параметры

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

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

  • xlDescending. Выполняет сортировку Key1 по убыванию.

  • xlAscending. Выполняет сортировку Key1 по возрастанию.

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

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

  • xlSortLabels. Сортирует отчет сводной таблицы по меткам.

  • xlSortValues. Сортирует отчет сводной таблицы по значениям.

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

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

  • xlStroke. Сортировка по количеству штрихов в каждом знаке.

  • xlPinYin. Порядок сортировки для символов, основанный на фонетике китайского языка.

• 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

Заметки

Параметры для Header, Order1, Order2, Order3, OrderCustom и Orientation сохраняются для конкретного листа каждый раз при использовании этого метода. Если не задать значения этих аргументов, при следующем вызове данного метода будут использоваться сохраненные значения. Если использовать сохраненные значения не требуется, задавайте эти аргументы явно при каждом использовании данного метода.

Текстовые строки, которые нельзя преобразовать в числовые данные, сортируются обычным способом.

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

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

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

Примеры

В следующем примере кода набор целочисленных значений помещается в ячейки от A1 до A5, после чего с помощью метода Sort выполняется сортировка данных по возрастанию.

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

Private Sub SortNamedRange()
    ' Set some data in a range of cells.
    Me.Range("A1").Value2 = 30
    Me.Range("A2").Value2 = 10
    Me.Range("A3").Value2 = 20
    Me.Range("A4").Value2 = 50
    Me.Range("A5").Value2 = 40

    ' Create a NamedRange that refers to the range.
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Sort the NamedRange.
    namedRange1.Sort(Me.Range("A1", "A5"), _
        Excel.XlSortOrder.xlAscending, , , _
        Excel.XlSortOrder.xlAscending, , _
        Excel.XlSortOrder.xlAscending, Excel.XlYesNoGuess.xlNo, , , _
        Excel.XlSortOrientation.xlSortColumns, _
        Excel.XlSortMethod.xlStroke, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal)
End Sub

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1", missing].Value2 = 30;
    this.Range["A2", missing].Value2 = 10;
    this.Range["A3", missing].Value2 = 20;
    this.Range["A4", missing].Value2 = 50;
    this.Range["A5", missing].Value2 = 40;

    // Create a NamedRange that refers to the range.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Sort the NamedRange.
    namedRange1.Sort(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.XlSortMethod.xlStroke,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);
}

Разрешения

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

См. также

Ссылки

NamedRange Класс

NamedRange - члены

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