NamedRange.Sort メソッド (2007 System)

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

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

1 番目の並べ替えフィールドです。テキスト (範囲名) または Microsoft.Office.Interop.Excel.Range オブジェクト (たとえば、"Dept" または Cells(1, 1)) を指定します。

Order1
型 : Microsoft.Office.Interop.Excel.XlSortOrder

Key1 に指定されたフィールドまたは範囲の並べ替え順序。

次のいずれかの XlSortOrder 値です。
- xlDescending 。Key1 を降順に並べ替えます。
- xlAscending 。Key1 を昇順に並べ替えます。

Key2
型 : System.Object

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

Type
型 : System.Object

どの要素を並べ替えるかを指定します。この引数は、ピボットテーブルレポートの並べ替えを行う場合のみ使用します。

次のいずれかの XlSortType 値です。
- xlSortLabels 。ピボットテーブルレポートをラベルによって並べ替えます。
- xlSortValues 。ピボットテーブルレポートを値によって並べ替えます。

Order2
型 : Microsoft.Office.Interop.Excel.XlSortOrder

Key2 に指定された範囲の並べ替え順序を指定します。ピボットテーブルレポートの並べ替えを行う場合は使用できません。

次のいずれかの XlSortOrder 値です。
- xlDescending 。Key2 を降順に並べ替えます。
- xlAscending 。Key2 を昇順に並べ替えます。

Key3
型 : System.Object

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

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

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

MatchCase
型 : System.Object

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

Orientation
型 : Microsoft.Office.Interop.Excel.XlSortOrientation

並べ替えの方向を指定します。

次のいずれかの XlSortOrientation 値です。
- xlSortRows 。行単位の並べ替えを行います。
- xlSortColumns 。列単位の並べ替えを行います。

SortMethod
型 : Microsoft.Office.Interop.Excel.XlSortMethod

並べ替えの種類を指定します。選択またはインストールした言語サポート (たとえば英語 (U.S.)) によっては、いくつかの定数を使用できない場合があります。

次のいずれかの 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 名前空間

次の方法で共有

NamedRange.Sort メソッド (2007 System)

構文

パラメータ

戻り値

解説

省略可能なパラメータ

例

アクセス許可

参照

参照

その他のリソース