SortedList<TKey,TValue> コンストラクター

定義

SortedList<TKey,TValue> クラスの新しいインスタンスを初期化します。

オーバーロード

SortedList<TKey,TValue>()

空で、既定の初期量を備え、既定の SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

SortedList<TKey,TValue>(IComparer<TKey>)

空で、既定の初期量を備え、指定した SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

SortedList<TKey,TValue>(IDictionary<TKey,TValue>)

指定した SortedList<TKey,TValue> からコピーした要素を格納し、コピーした要素の数を格納できるだけの容量を備え、既定の IDictionary<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

SortedList<TKey,TValue>(Int32)

空で、指定した初期量を備え、既定の SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>)

指定した SortedList<TKey,TValue> からコピーした要素を格納し、コピーした要素の数を格納できるだけの容量を備え、指定した IDictionary<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

SortedList<TKey,TValue>(Int32, IComparer<TKey>)

空で、指定した初期量を備え、指定した SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

SortedList<TKey,TValue>()

ソース:
SortedList.cs
ソース:
SortedList.cs
ソース:
SortedList.cs

空で、既定の初期量を備え、既定の SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

public:
 SortedList();
public SortedList ();
Public Sub New ()

次のコード例では、文字列キーを SortedList<TKey,TValue> 含む空の文字列を作成し、 メソッドを Add 使用していくつかの要素を追加します。 この例では、重複するキーを Add 追加しようとしたときに メソッドが を ArgumentException スローすることを示します。

このコード例は、SortedList<TKey,TValue> クラスのために提供されている大規模な例の一部です。

// Create a new sorted list of strings, with string
// keys.
SortedList<String^, String^>^ openWith =
    gcnew SortedList<String^, String^>();

// Add some elements to the list. There are no 
// duplicate keys, but some of the values are duplicates.
openWith->Add("txt", "notepad.exe");
openWith->Add("bmp", "paint.exe");
openWith->Add("dib", "paint.exe");
openWith->Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the list.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}
// Create a new sorted list of strings, with string
// keys.
SortedList<string, string> openWith =
    new SortedList<string, string>();

// Add some elements to the list. There are no
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the list.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
' Create a new sorted list of strings, with string 
' keys. 
Dim openWith As New SortedList(Of String, String)

' Add some elements to the list. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the list.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try
// Create a new sorted list of strings, with string
// keys.
let openWith = SortedList<string, string>()

// Add some elements to the list. There are no
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

// The Add method throws an exception if the new key is
// already in the list.
try
    openWith.Add("txt", "winword.exe");
with
    | :? ArgumentException ->
        printfn "An element with Key = \"txt\" already exists."

注釈

内のすべてのキーは SortedList<TKey,TValue> 、既定の比較子に従って一意である必要があります。

このコンストラクターは、 の初期容量に既定値を SortedList<TKey,TValue>使用します。 初期容量を設定するには、 コンストラクターを SortedList<TKey,TValue>(Int32) 使用します。 コレクションの最終的なサイズを見積もることができる場合、初期容量を指定すると、 に要素を追加しながら、多数のサイズ変更操作を実行する SortedList<TKey,TValue>必要がなくなります。

このコンストラクターでは、 の既定の比較子が TKey使用されます。 比較子を指定するには、 コンストラクターを SortedList<TKey,TValue>(IComparer<TKey>) 使用します。 既定の比較子 Comparer<T>.Default は、キー型 TKey がその実装を実装 System.IComparable<T> し、使用可能な場合はその実装を使用するかどうかを確認します。 そうでない場合は、 Comparer<T>.Default キー型 TKey が を実装しているかどうかを確認します System.IComparable。 キー型 TKey にどちらのインターフェイスも実装されていない場合は、パラメーターを System.Collections.Generic.IComparer<T> 受け取るコンストラクター オーバーロードで実装を comparer 指定できます。

このコンストラクターは O(1) 操作です。

こちらもご覧ください

適用対象

SortedList<TKey,TValue>(IComparer<TKey>)

ソース:
SortedList.cs
ソース:
SortedList.cs
ソース:
SortedList.cs

空で、既定の初期量を備え、指定した SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

public:
 SortedList(System::Collections::Generic::IComparer<TKey> ^ comparer);
public SortedList (System.Collections.Generic.IComparer<TKey> comparer);
public SortedList (System.Collections.Generic.IComparer<TKey>? comparer);
new System.Collections.Generic.SortedList<'Key, 'Value> : System.Collections.Generic.IComparer<'Key> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (comparer As IComparer(Of TKey))

パラメーター

comparer
IComparer<TKey>

キーの比較時に使用する IComparer<T> の実装。

- または -

キーの型に既定の Comparer<T> を使用する場合は null

次のコード例では、現在のカルチャの大文字と小文字を区別しない比較子を使用して、並べ替えられたリストを作成します。 この例では、小文字のキーを持つ要素と大文字のキーを持つ要素の 4 つを追加します。 その後、この例では、ケースによってのみ既存のキーと異なるキーを持つ要素の追加を試み、結果の例外をキャッチし、エラー メッセージを表示します。 最後に、大文字と小文字を区別しない並べ替え順序で要素を表示します。

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys and
        // a case-insensitive comparer for the current culture.
        SortedList<string, string> openWith =
                      new SortedList<string, string>(
                          StringComparer.CurrentCultureIgnoreCase);

        // Add some elements to the list.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the sorted list.");
        }

        // List the contents of the sorted list.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the sorted list.

Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted list of strings, with string keys and
        ' a case-insensitive comparer for the current culture.
        Dim openWith As New SortedList(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the list. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the sorted list.")
        End Try
        
        ' List the contents of the sorted list.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the sorted list.
'
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

注釈

内のすべてのキーは SortedList<TKey,TValue> 、指定された比較子に従って一意である必要があります。

このコンストラクターは、 の初期容量に既定値を SortedList<TKey,TValue>使用します。 初期容量を設定するには、 コンストラクターを SortedList<TKey,TValue>(Int32, IComparer<TKey>) 使用します。 コレクションの最終的なサイズを見積もることができる場合、初期容量を指定すると、 に要素を追加しながら、多数のサイズ変更操作を実行する SortedList<TKey,TValue>必要がなくなります。

このコンストラクターは O(1) 操作です。

こちらもご覧ください

適用対象

SortedList<TKey,TValue>(IDictionary<TKey,TValue>)

ソース:
SortedList.cs
ソース:
SortedList.cs
ソース:
SortedList.cs

指定した SortedList<TKey,TValue> からコピーした要素を格納し、コピーした要素の数を格納できるだけの容量を備え、既定の IDictionary<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

public:
 SortedList(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary);
public SortedList (System.Collections.Generic.IDictionary<TKey,TValue> dictionary);
new System.Collections.Generic.SortedList<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (dictionary As IDictionary(Of TKey, TValue))

パラメーター

dictionary
IDictionary<TKey,TValue>

新しい IDictionary<TKey,TValue> に要素がコピーされた SortedList<TKey,TValue>

例外

dictionarynullです。

dictionary には 1 つまたは複数の重複するキーが含まれます。

次のコード例では、 を使用 SortedList<TKey,TValue> して、 内の情報 Dictionary<TKey,TValue>の並べ替えられたコピーを作成し、 をコンストラクターに渡 Dictionary<TKey,TValue> す方法を SortedList<TKey,TValue>(IDictionary<TKey,TValue>) 示します。

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new Dictionary of strings, with string keys.
        //
        Dictionary<string, string> openWith =
                                  new Dictionary<string, string>();

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Create a SortedList of strings with string keys,
        // and initialize it with the contents of the Dictionary.
        SortedList<string, string> copy =
                  new SortedList<string, string>(openWith);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new Dictionary of strings, with string 
        ' keys.
        Dim openWith As New Dictionary(Of String, String)
        
        ' Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a SortedList of strings with string keys, 
        ' and initialize it with the contents of the Dictionary.
        Dim copy As New SortedList(Of String, String)(openWith)

        ' List the sorted contents of the copy.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In copy
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

注釈

SortedList<TKey,TValue> のすべてのキーは、既定の比較子に従って一意である必要があります。同様に、ソース dictionary 内のすべてのキーも、既定の比較子に従って一意である必要があります。

新しい SortedList<TKey,TValue> の容量は 内 dictionaryの要素の数に設定されるため、リストの設定中にサイズ変更は行われません。

このコンストラクターでは、 の既定の比較子が TKey使用されます。 比較子を指定するには、 コンストラクターを SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) 使用します。 既定の比較子 Comparer<T>.Default は、キー型 TKey がその実装を実装 System.IComparable<T> し、使用可能な場合はその実装を使用するかどうかを確認します。 そうでない場合は、 Comparer<T>.Default キー型 TKey が を実装しているかどうかを確認します System.IComparable。 キー型 TKey にどちらのインターフェイスも実装されていない場合は、パラメーターを System.Collections.Generic.IComparer<T> 受け取るコンストラクター オーバーロードで実装を comparer 指定できます。

dictionary キーは新しい SortedList<TKey,TValue> にコピーされ、1 回並べ替えられます。これにより、このコンストラクターは O(n log n) 操作になります。

こちらもご覧ください

適用対象

SortedList<TKey,TValue>(Int32)

ソース:
SortedList.cs
ソース:
SortedList.cs
ソース:
SortedList.cs

空で、指定した初期量を備え、既定の SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

public:
 SortedList(int capacity);
public SortedList (int capacity);
new System.Collections.Generic.SortedList<'Key, 'Value> : int -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (capacity As Integer)

パラメーター

capacity
Int32

SortedList<TKey,TValue> が格納できる要素数の初期値。

例外

capacity が 0 未満です。

次のコード例では、最初の容量が 4 の並べ替えられたリストを作成し、4 つのエントリを設定します。

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys and
        // an initial capacity of 4.
        SortedList<string, string> openWith =
                               new SortedList<string, string>(4);

        // Add 4 elements to the list.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // List the contents of the sorted list.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted list of strings, with string keys and
        ' an initial capacity of 4.
        Dim openWith As New SortedList(Of String, String)(4)
        
        ' Add 4 elements to the list. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' List the contents of the sorted list.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

注釈

内のすべてのキーは SortedList<TKey,TValue> 、既定の比較子に従って一意である必要があります。

SortedList<TKey,TValue> 容量は、 のサイズを変更する前に SortedList<TKey,TValue> 保持できる要素の数です。 要素が に SortedList<TKey,TValue>追加されると、内部配列を再割り当てすることで、必要に応じて容量が自動的に増加します。

コレクションのサイズを見積もることができる場合、初期容量を指定すると、 に要素を追加しながら、多数のサイズ変更操作を実行する SortedList<TKey,TValue>必要がなくなります。

を呼び出 TrimExcess すか、 プロパティを明示的に設定することで、容量を Capacity 減らすことができます。 容量を減らすと、メモリが再割り当てされ、 内のすべての要素がコピーされます SortedList<TKey,TValue>

このコンストラクターでは、 の既定の比較子が TKey使用されます。 比較子を指定するには、 コンストラクターを SortedList<TKey,TValue>(Int32, IComparer<TKey>) 使用します。 既定の比較子 Comparer<T>.Default は、キー型 TKey がその実装を実装 System.IComparable<T> し、使用可能な場合はその実装を使用するかどうかを確認します。 そうでない場合は、 Comparer<T>.Default キー型 TKey が を実装しているかどうかを確認します System.IComparable。 キー型 TKey にどちらのインターフェイスも実装されていない場合は、パラメーターを System.Collections.Generic.IComparer<T> 受け取るコンストラクター オーバーロードで実装を comparer 指定できます。

このコンストラクターは O(n) 操作です。ここで n 、 は capacityです。

こちらもご覧ください

適用対象

SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>)

ソース:
SortedList.cs
ソース:
SortedList.cs
ソース:
SortedList.cs

指定した SortedList<TKey,TValue> からコピーした要素を格納し、コピーした要素の数を格納できるだけの容量を備え、指定した IDictionary<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

public:
 SortedList(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary, System::Collections::Generic::IComparer<TKey> ^ comparer);
public SortedList (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IComparer<TKey> comparer);
public SortedList (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IComparer<TKey>? comparer);
new System.Collections.Generic.SortedList<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> * System.Collections.Generic.IComparer<'Key> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (dictionary As IDictionary(Of TKey, TValue), comparer As IComparer(Of TKey))

パラメーター

dictionary
IDictionary<TKey,TValue>

新しい IDictionary<TKey,TValue> に要素がコピーされた SortedList<TKey,TValue>

comparer
IComparer<TKey>

キーの比較時に使用する IComparer<T> の実装。

- または -

キーの型に既定の Comparer<T> を使用する場合は null

例外

dictionarynullです。

dictionary には 1 つまたは複数の重複するキーが含まれます。

次のコード例は、 を使用SortedList<TKey,TValue>して、 をコンストラクターに渡Dictionary<TKey,TValue>すことによって、大文字と小文字を区別しないDictionary<TKey,TValue>情報の並べ替えられたコピーを作成する方法をSortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>)示しています。 この例では、大文字と小文字を区別しない比較子は現在のカルチャ用です。

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new Dictionary of strings, with string keys and
        // a case-insensitive equality comparer for the current
        // culture.
        Dictionary<string, string> openWith =
            new Dictionary<string, string>
                (StringComparer.CurrentCultureIgnoreCase);

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("Bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Create a SortedList of strings with string keys and a
        // case-insensitive equality comparer for the current culture,
        // and initialize it with the contents of the Dictionary.
        SortedList<string, string> copy =
            new SortedList<string, string>(openWith,
                StringComparer.CurrentCultureIgnoreCase);

        // List the sorted contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = Bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new Dictionary of strings, with string keys and
        ' a case-insensitive equality comparer for the current 
        ' culture.
        Dim openWith As New Dictionary(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("Bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a SortedList of strings with string keys and a 
        ' case-insensitive equality comparer for the current culture,
        ' and initialize it with the contents of the Dictionary.
        Dim copy As New SortedList(Of String, String)(openWith, _
            StringComparer.CurrentCultureIgnoreCase)

        ' List the sorted contents of the copy.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In copy
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = Bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

注釈

SortedList<TKey,TValue> のすべてのキーは、指定された比較子に従って一意である必要があります。同様に、ソース dictionary 内のすべてのキーも、指定された比較子に従って一意である必要があります。

新しい SortedList<TKey,TValue> の容量は 内 dictionaryの要素の数に設定されるため、リストの設定中にサイズ変更は行われません。

dictionary キーは新しい SortedList<TKey,TValue> にコピーされ、1 回並べ替えられます。これにより、このコンストラクターは O(n log n) 操作になります。

こちらもご覧ください

適用対象

SortedList<TKey,TValue>(Int32, IComparer<TKey>)

ソース:
SortedList.cs
ソース:
SortedList.cs
ソース:
SortedList.cs

空で、指定した初期量を備え、指定した SortedList<TKey,TValue> を使用する、IComparer<T> クラスの新しいインスタンスを初期化します。

public:
 SortedList(int capacity, System::Collections::Generic::IComparer<TKey> ^ comparer);
public SortedList (int capacity, System.Collections.Generic.IComparer<TKey> comparer);
public SortedList (int capacity, System.Collections.Generic.IComparer<TKey>? comparer);
new System.Collections.Generic.SortedList<'Key, 'Value> : int * System.Collections.Generic.IComparer<'Key> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (capacity As Integer, comparer As IComparer(Of TKey))

パラメーター

capacity
Int32

SortedList<TKey,TValue> が格納できる要素数の初期値。

comparer
IComparer<TKey>

キーの比較時に使用する IComparer<T> の実装。

- または -

キーの型に既定の Comparer<T> を使用する場合は null

例外

capacity が 0 未満です。

次のコード例では、初期容量が 5 の並べ替えられたリストと、現在のカルチャの大文字と小文字を区別しない比較子を作成します。 この例では、小文字のキーを持つ要素と大文字のキーを持つ要素の 4 つを追加します。 その後、この例では、ケースによってのみ既存のキーと異なるキーを持つ要素の追加を試み、結果の例外をキャッチし、エラー メッセージを表示します。 最後に、大文字と小文字を区別しない並べ替え順序で要素を表示します。

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys, an
        // initial capacity of 5, and a case-insensitive comparer.
        SortedList<string, string> openWith =
                      new SortedList<string, string>(5,
                          StringComparer.CurrentCultureIgnoreCase);

        // Add 4 elements to the list.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the sorted list.");
        }

        // List the contents of the sorted list.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the sorted list.

Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted list of strings, with string keys, an
        ' initial capacity of 5, and a case-insensitive comparer.
        Dim openWith As New SortedList(Of String, String)(5, _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add 4 elements to the list. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the sorted list.")
        End Try
        
        ' List the contents of the sorted list.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the sorted list.
'
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

注釈

内のすべてのキーは SortedList<TKey,TValue> 、指定された比較子に従って一意である必要があります。

SortedList<TKey,TValue> 容量は、 のサイズを変更する前に SortedList<TKey,TValue> 保持できる要素の数です。 要素が に SortedList<TKey,TValue>追加されると、内部配列を再割り当てすることで、必要に応じて容量が自動的に増加します。

コレクションのサイズを見積もることができる場合、初期容量を指定すると、 に要素を追加しながら、多数のサイズ変更操作を実行する SortedList<TKey,TValue>必要がなくなります。

を呼び出 TrimExcess すか、 プロパティを明示的に設定することで、容量を Capacity 減らすことができます。 容量を減らすと、メモリが再割り当てされ、 内のすべての要素がコピーされます SortedList<TKey,TValue>

このコンストラクターは O(n) 操作です。ここで n 、 は capacityです。

こちらもご覧ください

適用対象