SortedList.IndexOfKey(Object) メソッド

public:
 virtual int IndexOfKey(System::Object ^ key);

public virtual int IndexOfKey(object key);

abstract member IndexOfKey : obj -> int
override this.IndexOfKey : obj -> int

Public Overridable Function IndexOfKey (key As Object) As Integer

パラメーター

返品

SortedList オブジェクトにkeyが見つかった場合は、key パラメーターの 0 から始まるインデックス。それ以外の場合は -1。

例外

例

次のコード例は、 SortedList オブジェクト内のキーまたは値のインデックスを決定する方法を示しています。

using System;
using System.Collections;
public class SamplesSortedList  {

   public static void Main()  {

      // Creates and initializes a new SortedList.
      SortedList mySL = new SortedList();
      mySL.Add( 1, "one" );
      mySL.Add( 3, "three" );
      mySL.Add( 2, "two" );
      mySL.Add( 4, "four" );
      mySL.Add( 0, "zero" );

      // Displays the values of the SortedList.
      Console.WriteLine( "The SortedList contains the following values:" );
      PrintIndexAndKeysAndValues( mySL );

      // Searches for a specific key.
      int myKey = 2;
      Console.WriteLine( "The key \"{0}\" is at index {1}.", myKey, mySL.IndexOfKey( myKey ) );

      // Searches for a specific value.
      string myValue = "three";
      Console.WriteLine( "The value \"{0}\" is at index {1}.", myValue, mySL.IndexOfValue( myValue ) );
   }

   public static void PrintIndexAndKeysAndValues( SortedList myList )  {
      Console.WriteLine( "\t-INDEX-\t-KEY-\t-VALUE-" );
      for ( int i = 0; i < myList.Count; i++ )  {
         Console.WriteLine( "\t[{0}]:\t{1}\t{2}", i, myList.GetKey(i), myList.GetByIndex(i) );
      }
      Console.WriteLine();
   }
}
/*
This code produces the following output.

The SortedList contains the following values:
    -INDEX-    -KEY-    -VALUE-
    [0]:    0    zero
    [1]:    1    one
    [2]:    2    two
    [3]:    3    three
    [4]:    4    four

The key "2" is at index 2.
The value "three" is at index 3.
*/

Imports System.Collections

Public Class SamplesSortedList    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new SortedList.
        Dim mySL As New SortedList()
        mySL.Add(1, "one")
        mySL.Add(3, "three")
        mySL.Add(2, "two")
        mySL.Add(4, "four")
        mySL.Add(0, "zero")
        
        ' Displays the values of the SortedList.
        Console.WriteLine("The SortedList contains the " & _
           "following values:")
        PrintIndexAndKeysAndValues(mySL)
        
        ' Searches for a specific key.
        Dim myKey As Integer = 2
        Console.WriteLine("The key ""{0}"" is at index {1}.", myKey, _
           mySL.IndexOfKey(myKey))
        
        ' Searches for a specific value.
        Dim myValue As String = "three"
        Console.WriteLine("The value ""{0}"" is at index {1}.", myValue, _
           mySL.IndexOfValue(myValue))
    End Sub    
    
    
    Public Shared Sub PrintIndexAndKeysAndValues(myList As SortedList)
        Console.WriteLine(ControlChars.Tab & "-INDEX-" & ControlChars.Tab & _
           "-KEY-" & ControlChars.Tab & "-VALUE-")
        Dim i As Integer
        For i = 0 To myList.Count - 1
            Console.WriteLine(ControlChars.Tab & "[{0}]:" & ControlChars.Tab & _
               "{1}" & ControlChars.Tab & "{2}", i, myList.GetKey(i), _
               myList.GetByIndex(i))
        Next i
        Console.WriteLine()
    End Sub
End Class

' This code produces the following output.
' 
' The SortedList contains the following values:
'     -INDEX-    -KEY-    -VALUE-
'     [0]:    0    zero
'     [1]:    1    one
'     [2]:    2    two
'     [3]:    3    three
'     [4]:    4    four
'
' The key "2" is at index 2.
' The value "three" is at index 3.

注釈

SortedList オブジェクトの要素は、SortedListの作成時に指定された特定のIComparer実装に従うか、キー自体によって提供されるIComparable実装に従って、キーによって並べ替えられます。

インデックス シーケンスは、並べ替え順序に基づいています。 要素が追加されると、正しい並べ替え順序で SortedList に挿入され、それに応じてインデックスが調整されます。 要素が削除されると、インデックス作成もそれに応じて調整されます。 そのため、要素が SortedListに追加または削除されると、特定のキーと値のペアのインデックスが変更される可能性があります。

このメソッドはバイナリ検索アルゴリズムを使用します。したがって、このメソッドは O(log n) 操作であり、 n が Count。

このメソッドは、itemでコレクションのオブジェクトのEqualsメソッドとCompareTo メソッドを使用して、itemが存在するかどうかを判断します。

こちらもご覧ください

• ContainsKey(Object)
• IndexOfValue(Object)
• コレクションでの Culture-Insensitive 文字列操作の実行