次の方法で共有


NamedRange.Sort メソッド

定義

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. 数値データとテキスト データを区別して並べ替えます。

戻り値

次のコード例では、セル 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

注釈

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

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

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

省略可能のパラメーター

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

適用対象