Range.Sort メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した範囲にセルが 1 つしかない場合は、ピボットテーブル レポート、範囲、またはアクティブな領域を並べ替えます。
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);
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
オプションの オブジェクト。 1 つ目の並べ替えフィールド。テキスト (ピボットテーブルのフィールドや範囲名) または Range オブジェクト (たとえば、Dept" や Cells(1, 1) など)。
- Order1
- XlSortOrder
オプションの XlSortOrder。
Key1 で指定されているフィールドまたは範囲の並べ替え順序。 次のいずれかの XlSortOrder 定数を指定できます。xlDescending。 降順で Key1 並べ替えます。xlAscendingdefault。 昇順で並べ替える Key1 。
- Key2
- Object
オプションの オブジェクト。 2 番目の並べ替えフィールドを、テキスト (ピボットテーブル フィールドまたは範囲名) または Range オブジェクトで指定します。 この引数を省略すると、2 つ目の並べ替えフィールドはありません。 ピボット テーブル レポートの並べ替えには使用できません。
- Type
- Object
オプションの オブジェクト。 並べ替える要素を指定します。 この引数は、ピボットテーブル レポートを並べ替えるときにのみ使用します。 次のいずれかの XlSortType 定数を使用できます。xlSortLabels。 ピボットテーブル レポートをラベルで並べ替えます。xlSortValues. ピボットテーブル レポートを値で並べ替えます。
- Order2
- XlSortOrder
オプションの XlSortOrder。
Key2 で指定されているフィールドまたは範囲の並べ替え順序。 ピボットテーブル レポートの並べ替えには使用できません。 次のいずれかの XlSortOrder 定数を指定できます。xlDescending。 降順で Key2 並べ替えます。xlAscendingdefault。 昇順で並べ替える Key2 。
- Key3
- Object
オプションの オブジェクト。 3 番目の並べ替えフィールドを、テキスト (範囲名) または Range オブジェクトで指定します。 この引数を省略すると、3 つ目の並べ替えフィールドはありません。 ピボットテーブル レポートの並べ替えには使用できません。
- Order3
- XlSortOrder
オプションの XlSortOrder。
Key3 で指定されているフィールドまたは範囲の並べ替え順序。 ピボットテーブル レポートの並べ替えには使用できません。 次のいずれかの XlSortOrder 定数を指定できます。xlDescending。 降順で Key3 並べ替えます。xlAscendingdefault。 昇順で並べ替える Key3 。
- Header
- XlYesNoGuess
オプションの XlYesNoGuess。 先頭の行に見出しを含めるかどうかを指定します。 ピボットテーブル レポートの並べ替えには使用できません。 次の XlYesNoGuess 定数のいずれかを指定できます。xlGuess。 Microsoft Excel でヘッダーがあるかどうかを判断し、ヘッダーがある場合はどこにあるかを判断します。いいえdefault。 (範囲全体を並べ替える必要があります)。xlYes です。 (範囲全体を並べ替えないでください)。
- OrderCustom
- Object
オプションの オブジェクト。 この引数は、ユーザー設定の並べ替え順のリスト内の番号を示す、1 から始まる整数です。
OrderCustomを省略すると、通常の並べ替えが使用されます。
- MatchCase
- Object
オプションの オブジェクト。 大文字と小文字を区別した並べ替えを行う場合は true。大文字と小文字が区別されない並べ替えを行う場合は false。 ピボットテーブル レポートの並べ替えには使用できません。
- Orientation
- XlSortOrientation
オプションの XlSortOrientation。 並べ替えの方向を指定します。 次の XlSortOrientation 定数のいずれかを指定できます。xlSortRowsdefault。 行で並べ替えます。xlSortColumns. 列単位で並べ替えます。
- SortMethod
- XlSortMethod
オプションの XlSortMethod。 並べ替えの種類を指定します。 選択またはインストールされている言語の設定 (たとえば、日本語) によって、これらのいくつかの定数が使用できない場合があります。 次の XlSortMethod 定数のいずれかを指定できます。xlStroke 各文字のストローク数で並べ替えます。xlPinYindefault. 中国語の発音表記の順で並べ替えます。
- DataOption1
- XlSortDataOption
オプションの XlSortDataOption。
Key 1 でテキストを並べ替える方法を指定します。 ピボットテーブル レポートの並べ替えには使用できません。 次の XlSortDataOption 定数のいずれかを指定できます。xlSortTextAsNumbers。 テキストを、並べ替えの数値データとして扱う。xlSortNormaldefault。 数値データとテキスト データを別々に並べ替えます。
- DataOption2
- XlSortDataOption
オプションの XlSortDataOption。
Key 2 でテキストを並べ替える方法を指定します。 ピボットテーブル レポートの並べ替えには使用できません。 次の XlSortDataOption 定数のいずれかを指定できます。xlSortTextAsNumbers。 テキストは、並べ替えの数値データとして扱われます。xlSortNormaldefault。 数値データとテキスト データを別々に並べ替えます。
- DataOption3
- XlSortDataOption
オプションの XlSortDataOption。 キー 3 のテキストの並べ替え方法を指定します。 ピボットテーブル レポートの並べ替えには使用できません。 次の XlSortDataOption 定数のいずれかを指定できます。xlSortTextAsNumbers。 テキストは、並べ替えの数値データとして扱われます。xlSortNormaldefault。 数値データとテキスト データを別々に並べ替えます。
返品
注釈
この方法を使用するたびに、特定のワークシートの Header、 Order1、 Order2、 Order3、 OrderCustom、および Orientation の設定が保存されます。 これらの引数の値を指定しないと、次にメソッドを呼び出すときに、保存された値が使用されます。 保存した値を使用しない場合は、 並べ替え 方法を使用するたびにこれらの引数を明示的に設定してください。
数値データに変換できないテキスト文字列は、通常どおりソートされます。
Sort メソッドで引数を何も定義しない場合、選択している範囲が昇順で並べ替えられます。