NamedRange.SortSpecial メソッド

リファレンス

定義

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

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

重要

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

アジア言語の並べ替え方式を使用して NamedRange コントロールの並べ替えを行います。たとえば、日本語のふりがなを使った並べ替え順序があります。詳細については、パラメーターの一覧を参照してください。

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

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

パラメーター

SortMethod: XlSortMethod

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

Key1: Object

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

Order1: XlSortOrder

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

Type: Object

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

Key2: Object

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

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. 列単位の並べ替えを行います。

DataOption1: XlSortDataOption

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

DataOption2: XlSortDataOption

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

DataOption3: XlSortDataOption

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

戻り値

Object

例

次のコード例では、メソッドを SortSpecial 使用して NamedRange Pin Yin (文字の中国語のふりがなの並べ替え順序) を使用してを並べ替えます。中国語の文字を並べ替えるために、この例では、ユーザーが Microsoft Office Excel の中国語サポートを受けているものとします。ユーザーが中国語を NamedRange サポートしていない場合、Excel では既定で値による並べ替えが行われます。

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

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);

}

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

注釈

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

省略可能のパラメーター

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

適用対象

次の方法で共有

NamedRange.SortSpecial メソッド

定義

パラメーター

戻り値

例

注釈

省略可能のパラメーター

適用対象

その他のリソース