SortedList.Keys プロパティ

.NET Framework クラス ライブラリ リファレンス

SortedList.Keys プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

SortedList 内のキーを格納しているコレクションを取得します。

名前空間: System.Collections.Generic
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Keys As IList(Of TKey)

Visual Basic (使用法)

Dim instance As SortedList(Of
 TKey, TValue)
Dim value As IList(Of TKey)

value = instance.Keys

C#

public IList<TKey> Keys { get; }

C++

public:
property IList<TKey>^ Keys {
    IList<TKey>^ get ();
}

J#

/** @property */
public IList<TKey> get_Keys ()

JScript

public function get Keys
 () : IList<TKey>

プロパティ値
SortedList 内のキーを格納している IList。

解説

IList 内のキーの順序は、SortedList 内での順序と同じです。

返される IList は静的なコピーではありません。代わりに、この IList は、元の SortedList のキーを参照します。そのため、SortedList に対する変更は、IList にも反映されます。

Keys プロパティによって返されるコレクションを使用すると、キーを効率的にインデックスで取得できます。リストはキーの内部配列の単なるラッパーなので、プロパティへのアクセス時にリストを再生成する必要はありません。Keys プロパティを使用して、文字列キーを持つ要素の並べ替えられたリストのキーをインデックスで取得するコード例を次に示します。

Visual Basic

Dim k As String = mySortedList.Keys(3)

C#

string k = mySortedList.Keys[3];

C++

String^ k = mySortedList->Keys[3];

このプロパティ値を取得することは、O(1) 操作になります。

使用例

Keys プロパティを使用して並べ替えられたリストのキーを列挙する方法、および並べ替えられたリストのキーおよび値を列挙する方法を次のコード例に示します。

この例では、Keys プロパティを使用して、キーをインデックスで効率的に取得する方法も示します。

このコードは、コンパイルして実行することのできる例の一部です。詳細については、SortedList のトピックを参照してください。

Visual Basic

        ' To get the keys alone, use the Keys property.
        Dim ilistKeys As IList(Of
 String) = openWith.Keys
        
        ' The elements of the list are strongly typed with the
        ' type that was specified for the SortedList keys.
        Console.WriteLine()
        For Each s As String
 In ilistKeys 
            Console.WriteLine("Key = {0}", s)
        Next s

        ' The Keys property is an efficient way to retrieve
        ' keys by index.
        Console.WriteLine(vbLf & "Indexed retrieval using
 the " & _
            "Keys property: Keys(2) = {0}", openWith.Keys(2))
<br /><span space="preserve">...</span><br
 />        ' When you use foreach to enumerate list elements,
        ' the elements are retrieved as KeyValuePair objects.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In openWith
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

C#

        // To get the keys alone, use the Keys property.
        IList<string> ilistKeys = openWith.Keys;

        // The elements of the list are strongly typed with the 
        // type that was specified for the SortedList keys.
        Console.WriteLine();
        foreach( string s in
 ilistKeys )
        {
            Console.WriteLine("Key = {0}", s);
        }

        // The Keys property is an efficient way to retrieve
        // keys by index.
        Console.WriteLine("\nIndexed retrieval using the
 Keys " +
            "property: Keys[2] = {0}", openWith.Keys[2]);
<br /><span space="preserve">...</span><br /> 
       // When you use foreach to enumerate list elements,
        // the elements are retrieved as KeyValuePair objects.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", 
                kvp.Key, kvp.Value);
        }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SortedList ジェネリック クラス
SortedList メンバ
System.Collections.Generic 名前空間
IList ジェネリック インターフェイス
Values

SortedList.Keys プロパティ

SortedList 内のキーを取得します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property Keys As ICollection

Visual Basic (使用法)

Dim instance As SortedList
Dim value As ICollection

value = instance.Keys

C#

public virtual ICollection Keys { get; }

C++

public:
virtual property ICollection^ Keys {
    ICollection^ get ();
}

J#

/** @property */
public ICollection get_Keys ()

JScript

public function get Keys
 () : ICollection

プロパティ値
SortedList 内のキーを格納している ICollection。

解説

ICollection は、SortedList のキーの読み取り専用ビューです。基になる SortedList が変更されると、その変更はすぐに ICollection に反映されます。

ICollection の要素は、SortedList のキーと同じ順序で並べ替えられます。

GetKeyList に類似していますが、IList ではなく ICollection を返します。

このメソッドは O(1) 操作です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SortedList クラス
SortedList メンバ
System.Collections 名前空間
ICollection インターフェイス
Values
GetKeyList
その他の技術情報
カルチャを認識しないコレクションの操作の実行