NamedRange.Sort - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
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

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

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

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

См. также

Ссылки

NamedRange Интерфейс

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

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