NamedRange.Sort メソッド

リファレンス

定義

名前空間:: Microsoft.Office.Tools.Excel

アセンブリ:: Microsoft.Office.Tools.Excel.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

NamedRange コントロール内のデータを並べ替えます。

public object Sort (object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key2, object Type, 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.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, 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 Sort : 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.XlSortMethod * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function Sort (Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key2 As Object, Optional Type 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 SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, 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

パラメーター

Key1: Object

テキスト (範囲名) またはオブジェクト ("Dept" または Range Cells(1, 1) などの 1 番目の並べ替えフィールド。

Order1: XlSortOrder

でKey1指定されたフィールドまたは範囲の並べ替え順序。次のいずれかの値をXlSortOrder指定できます。 xlDescending Key1降順で並べ替えます。 xlAscending. Key1昇順で並べ替えます。

Key2: Object

2 番目の並べ替えフィールドです。テキスト (範囲名) または Range オブジェクトを指定します。この引数を省略した場合、2 番目の並べ替えフィールドはありません。

Type: Object

どの要素を並べ替えるかを指定します。この引数は、ピボットテーブルレポートを並べ替える場合にのみ使用します。次のいずれかの値をXlSortType指定できます。 xlSortLabels ピボットテーブルレポートをラベルによって並べ替えます。 xlSortValues. ピボットテーブルレポートを値によって並べ替えます。

Order2: XlSortOrder

で Key2指定された範囲の並べ替え順序。ピボットテーブルレポートを並べ替えるときは使用できません。次のいずれかの値をXlSortOrder指定できます。 xlDescending Key2降順で並べ替えます。 xlAscending. Key2昇順で並べ替えます。

Key3: Object

3 番目の並べ替えフィールドです。テキスト (範囲名) または Range オブジェクトを指定します。この引数を省略した場合、3 番目の並べ替えフィールドはありません。ピボットテーブルレポートの並べ替えを行う場合は使用できません。

Order3: XlSortOrder

で Key3指定されたフィールドまたは範囲の並べ替え順序。ピボットテーブルレポートを並べ替えるときは使用できません。次のいずれかの値をXlSortOrder指定できます。 xlDescending Key3降順で並べ替えます。 xlAscending. Key3昇順で並べ替えます。

Header: XlYesNoGuess

先頭行にヘッダーがあるかどうかを指定します。ピボットテーブルレポートを並べ替えるときは使用できません。次のいずれかの値をXlYesNoGuess指定できます。 xlGuess ヘッダーがあるかどうか、ある場合はその場所を、Microsoft Office Excel が推測するようにします。 xlNo. これを指定すると、範囲全体の並べ替えが行われます。 xlYes. これを指定すると、並べ替えは範囲全体ではなくなります。

OrderCustom: Object

この引数には、ユーザー設定並べ替え順序リストへの 1 を基準にした整数オフセットを指定します。を省略 OrderCustomすると、通常の並べ替えが使用されます。

MatchCase: Object

大文字と小文字を区別する並べ替えを行う場合は、true を指定します。大文字と小文字を区別しない並べ替えを行う場合は、false を指定します。ピボットテーブルレポートの並べ替えを行う場合は使用できません。

Orientation: XlSortOrientation

並べ替えの向き。次のいずれかの値をXlSortOrientation指定できます。 xlSortRows 行単位の並べ替えを行います。 xlSortColumns. 列単位の並べ替えを行います。

SortMethod: XlSortMethod

並べ替えの種類を指定します。選択またはインストールした言語のサポート (たとえば、英語) によっては、これらの定数の一部を使用できない場合があります。次のいずれかの値をXlSortMethod指定できます。 xlStroke 各文字の画数によって並べ替えます。 xlPinYin. 文字を中国語の発音順序で並べ替えます。

DataOption1: XlSortDataOption

でテキストを並べ替える方法を key1指定します。ピボットテーブルレポートを並べ替えるときは使用できません。次のいずれかの値をXlSortDataOption指定できます。 xlSortTextAsNumbers 並べ替えを実行するときに文字列を数値データとして扱います。 xlSortNormal. 数値データとテキストデータを区別して並べ替えます。

DataOption2: XlSortDataOption

でテキストを並べ替える方法を key2指定します。ピボットテーブルレポートを並べ替えるときは使用できません。次のいずれかの値をXlSortDataOption指定できます。 xlSortTextAsNumbers 並べ替えを実行するときに文字列を数値データとして扱います。 xlSortNormal. 数値データとテキストデータを区別して並べ替えます。

DataOption3: XlSortDataOption

でテキストを並べ替える方法を key3指定します。ピボットテーブルレポートを並べ替えるときは使用できません。次のいずれかの値をXlSortDataOption指定できます。 xlSortTextAsNumbers 並べ替えを実行するときに文字列を数値データとして扱います。 xlSortNormal. 数値データとテキストデータを区別して並べ替えます。

戻り値

Object

例

次のコード例では、セル A1 から A5 に整数のセットを配置し、メソッドを Sort 使用してデータを昇順で並べ替えます。

この例は、ドキュメントレベルのカスタマイズ用です。

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].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);
}

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

注釈

、、Order1、Order2、Order3OrderCustomおよび Orientation のHeader設定は、このメソッドを使用するたびに、特定のワークシートに対して保存されます。次にメソッドを呼び出す際にこれらの引数の値を指定しない場合は、保存された値が使用されます。保存された値を使用しないことを選択した場合は、このメソッドを使用するたびにこれらの引数を明示的に設定します。

数値データに変換できないテキスト文字列は、通常どおりに並べ替えられます。

このメソッドで引数が定義されていない場合、Microsoft Office Excel は選択範囲を昇順で並べ替えます。

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。

適用対象

NamedRange.Sort メソッド

定義

パラメーター

戻り値

例

注釈

省略可能のパラメーター

適用対象

その他のリソース