SortedList<TKey,TValue>.Add(TKey, TValue) SortedList<TKey,TValue>.Add(TKey, TValue) SortedList<TKey,TValue>.Add(TKey, TValue) SortedList<TKey,TValue>.Add(TKey, TValue) Method

定義

指定したキーおよび値を持つ要素を SortedList<TKey,TValue> に追加します。Adds an element with the specified key and value into the SortedList<TKey,TValue>.

public:
 virtual void Add(TKey key, TValue value);
public void Add (TKey key, TValue value);
abstract member Add : 'Key * 'Value -> unit
override this.Add : 'Key * 'Value -> unit
Public Sub Add (key As TKey, value As TValue)

パラメーター

key
TKey TKey TKey TKey

追加する要素のキー。The key of the element to add.

value
TValue TValue TValue TValue

追加する要素の値。The value of the element to add. 参照型の場合は null の値を使用できます。The value can be null for reference types.

実装

例外

同じキーを持つ要素が、SortedList<TKey,TValue> に既に存在します。An element with the same key already exists in the SortedList<TKey,TValue>.

次のコード例は、空を作成します。SortedList<TKey,TValue>文字列を使用して文字列のキーの、Addメソッドをいくつかの要素を追加します。The following code example creates an empty SortedList<TKey,TValue> of strings with string keys and uses the Add method to add some elements. 例を示しますが、Addメソッドがスローされます、ArgumentException重複するキーを追加しようとしています。The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

このコード例が示されている例の一部、SortedList<TKey,TValue>クラス。This code example is part of a larger example provided for the SortedList<TKey,TValue> class.

// 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

注釈

キーにはnull、ですが場合の値が並べ替えられたリストに値の型TValue参照型です。A key cannot be null, but a value can be, if the type of values in the sorted list, TValue, is a reference type.

使用することも、Item[TKey]にキーの値を設定して、新しい要素を追加するプロパティが存在しません、 SortedList<TKey,TValue>。 たとえば、myCollection["myNonexistentKey"] = myValueします。You can also use the Item[TKey] property to add new elements by setting the value of a key that does not exist in the SortedList<TKey,TValue>; for example, myCollection["myNonexistentKey"] = myValue. ただしで指定したキーが既に存在する場合、SortedList<TKey,TValue>で、設定、Item[TKey]プロパティには、古い値が上書きされます。However, if the specified key already exists in the SortedList<TKey,TValue>, setting the Item[TKey] property overwrites the old value. これに対し、Addメソッドでは、既存の要素は変更しません。In contrast, the Add method does not modify existing elements.

場合Count既に等しいCapacityの容量、SortedList<TKey,TValue>は内部の配列を自動的に再割り当てによって向上し、新しい要素を追加する前に、既存の要素が新しい配列にコピーされます。If Count already equals Capacity, the capacity of the SortedList<TKey,TValue> is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

このメソッドは O (n) 並べ替えられていないデータは、操作、nCountします。This method is an O(n) operation for unsorted data, where n is Count. これは、O (log n) 操作の一覧の最後に、新しい要素が追加された場合。It is an O(log n) operation if the new element is added at the end of the list. カーソルでは、サイズ変更が発生する場合、操作は O (n)。If insertion causes a resize, the operation is O(n).

適用対象

こちらもご覧ください