SortedDictionary.Add メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SortedDictionary.Add メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したキーおよび値を持つ要素を SortedDictionary に追加します。

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

Visual Basic (宣言)

Public Sub Add ( _
    key As TKey, _
    value As TValue _
)

Visual Basic (使用法)

Dim instance As SortedDictionary(Of
 TKey, TValue)
Dim key As TKey
Dim value As TValue

instance.Add(key, value)

public void Add (
    TKey key,
    TValue value
)

C++

public:
virtual void Add (
    TKey key, 
    TValue value
) sealed

public final void Add (
    TKey key, 
    TValue value
)

JScript

public final function Add (
    key : TKey, 
    value : TValue
)

パラメータ

key: 追加する要素のキー。

value: 追加する要素の値。参照型の場合は、値を null 参照 (Visual Basic では Nothing) にできます。

例外

例外の種類	条件
ArgumentNullException	key が null 参照 (Visual Basic では Nothing) です。
ArgumentException	同じキーを持つ要素が、SortedDictionary に既に存在します。

解説

Item プロパティを使用すると、SortedDictionary 内に存在しないキーの値を設定することで、新しい要素を追加することもできます (例 : myCollection["myNonexistentKey"] = myValue) (Visual Basic では myCollection("myNonexistantKey") = myValue)。ただし、指定したキーが SortedDictionary 内に既に存在する場合、Item プロパティを設定すると既存の値が上書きされます。一方、Add メソッドは、指定したキーを持つ要素が既に存在する場合、例外をスローします。

キーを null 参照 (Visual Basic では Nothing) にすることはできませんが、値の型 TValue が参照型である場合、値を null にすることはできます。

このメソッドは O(log n) 操作です。ここで、n は Count です。

使用例

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

このコード例は、SortedDictionary クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Create a new sorted dictionary of strings, with string 
' keys. 
Dim openWith As New SortedDictionary(Of
 String, String)

' Add some elements to the dictionary. 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 dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt""
 already exists.")
End Try

// Create a new sorted dictionary of strings, with string
// keys.
SortedDictionary<string, string> openWith
 = 
    new SortedDictionary<string, string>();

// Add some elements to the dictionary. 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 dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}