NamedRange.SortSpecial メソッド
アジア言語の並べ替え方式を使用して NamedRange コントロールの並べ替えを行います。たとえば、日本語のふりがなを使った並べ替え順序があります。詳細については、パラメーターの一覧を参照してください。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
Function SortSpecial ( _
SortMethod As XlSortMethod, _
Key1 As Object, _
Order1 As XlSortOrder, _
Type As Object, _
Key2 As Object, _
Order2 As XlSortOrder, _
Key3 As Object, _
Order3 As XlSortOrder, _
Header As XlYesNoGuess, _
OrderCustom As Object, _
MatchCase As Object, _
Orientation As XlSortOrientation, _
DataOption1 As XlSortDataOption, _
DataOption2 As XlSortDataOption, _
DataOption3 As XlSortDataOption _
) As Object
Object SortSpecial(
XlSortMethod SortMethod,
Object Key1,
XlSortOrder Order1,
Object Type,
Object Key2,
XlSortOrder Order2,
Object Key3,
XlSortOrder Order3,
XlYesNoGuess Header,
Object OrderCustom,
Object MatchCase,
XlSortOrientation Orientation,
XlSortDataOption DataOption1,
XlSortDataOption DataOption2,
XlSortDataOption DataOption3
)
パラメーター
- SortMethod
型 : Microsoft.Office.Interop.Excel.XlSortMethod
並べ替えの種類を指定します。選択またはインストールした言語サポート (U.S. 英語など) によっては、これらの定数の一部を使用できない場合があります。
次のいずれかの XlSortMethod 値です。
xlStroke .各文字の画数によって並べ替えます。
xlPinYin (既定値)。文字を中国語の発音順序で並べ替えます。
- 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 を昇順に並べ替えます。
- Type
型 : System.Object
どの要素を並べ替えるかを指定します。この引数は、ピボットテーブル レポートの並べ替えを行う場合のみ使用します。
- Key2
型 : System.Object
2 番目の並べ替えフィールドです。テキスト (範囲名) または Microsoft.Office.Interop.Excel.Range オブジェクトを指定します。この引数を省略した場合、2 番目の並べ替えフィールドはありません。ピボットテーブル レポートの並べ替えを行う場合は使用できません。
- 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 .列単位の並べ替えを行います。
- 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
解説
このメソッドのどの引数も指定しなかった場合は、Microsoft Office Excel によって、選択範囲が昇順に並べ替えられます。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例は、SortSpecial メソッドを使用して、ぴん音 (中国語の発音による文字の並べ替え順序) で NamedRange を並べ替えます。この例では、中国語の文字を並べ替える場合、Microsoft Office Excel の中国語サポートを使用しているものと仮定しています。中国語サポートを使用していない場合は、Excel における NamedRange の既定の並べ替えは、値による並べ替えになります。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。
Private Sub SortSpecialNamedRange()
Me.Range("A1").Value2 = 50
Me.Range("A2").Value2 = 10
Me.Range("A3").Value2 = 20
Me.Range("A4").Value2 = 30
Me.Range("A5").Value2 = 40
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin, _
Me.Range("A1", "A5"), Excel.XlSortOrder.xlAscending, , , _
Excel.XlSortOrder.xlAscending, , _
Excel.XlSortOrder.xlAscending, _
Excel.XlYesNoGuess.xlNo, , , _
Excel.XlSortOrientation.xlSortColumns, _
Excel.XlSortDataOption.xlSortNormal, _
Excel.XlSortDataOption.xlSortNormal, _
Excel.XlSortDataOption.xlSortNormal)
End Sub
private void SortSpecialNamedRange()
{
this.Range["A1"].Value2 = 50;
this.Range["A2"].Value2 = 10;
this.Range["A3"].Value2 = 20;
this.Range["A4"].Value2 = 30;
this.Range["A5"].Value2 = 40;
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin,
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.XlSortDataOption.xlSortNormal,
Excel.XlSortDataOption.xlSortNormal,
Excel.XlSortDataOption.xlSortNormal);
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。