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

정의

제공된 키와 값을 가진 요소를 IDictionary<TKey,TValue>에 추가합니다.Adds an element with the provided key and value to the IDictionary<TKey,TValue>.

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

매개 변수

key
TKey TKey TKey TKey

추가할 요소의 키로 사용할 개체입니다.The object to use as the key of the element to add.

value
TValue TValue TValue TValue

추가할 요소의 값으로 사용할 개체입니다.The object to use as the value of the element to add.

예외

같은 키를 가진 요소가 이미 IDictionary<TKey,TValue>에 있는 경우An element with the same key already exists in the IDictionary<TKey,TValue>.

예제

다음 코드 예제에서는 빈 Dictionary<TKey,TValue> 의 문자열, 정수 키를 사용 하 여을 통해 액세스 된 IDictionary<TKey,TValue> 인터페이스입니다.The following code example creates an empty Dictionary<TKey,TValue> of strings, with integer keys, and accesses it through the IDictionary<TKey,TValue> interface. 사용 하 여 코드 예제는 Add 일부 요소를 추가 하는 방법입니다.The code example uses the Add method to add some elements. 예제에 합니다 Add 메서드가 throw는 ArgumentException 중복 키를 추가 하려고 할 때입니다.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

이 코드는 컴파일 및 실행할 수 있는 더 큰 예제의 일부입니다.This code is part of a larger example that can be compiled and executed. System.Collections.Generic.IDictionary<TKey,TValue>을 참조하세요.See System.Collections.Generic.IDictionary<TKey,TValue>.

// Create a new dictionary of strings, with string keys,
// and access it through the IDictionary generic interface.
IDictionary<String^, String^>^ openWith =
    gcnew Dictionary<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.");
}
// Create a new dictionary of strings, with string keys, 
// and access it through the IDictionary generic interface.
IDictionary<string, string> openWith = 
    new Dictionary<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.");
}
' Create a new dictionary of strings, with string keys, 
' and access it through the IDictionary generic interface.
Dim openWith As IDictionary(Of String, String) = _
    New Dictionary(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

설명

사용할 수도 있습니다는 Item[TKey] 속성 사전에 존재 하지 않는 키 값을 설정 하 여 새 요소를 추가 하려면 예를 들어 myCollection["myNonexistentKey"] = myValue C# (myCollection("myNonexistentKey") = myValue Visual Basic의).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 dictionary; for example, myCollection["myNonexistentKey"] = myValue in C# (myCollection("myNonexistentKey") = myValue in Visual Basic). 그러나 사전에 지정된 된 키가 이미 있는 경우 설정는 Item[TKey] 속성 이전 값을 덮어씁니다.However, if the specified key already exists in the dictionary, setting the Item[TKey] property overwrites the old value. 반면,는 Add 메서드는 기존 요소를 수정 하지 않습니다.In contrast, the Add method does not modify existing elements.

개체의 같음 여부를 결정 하는 방법의 구현을 달라질 수 있습니다. 예를 들어를 List<T> 클래스가 사용 하 Comparer<T>.Default반면를 Dictionary<TKey,TValue> 클래스를 사용 하면 사용자 지정는 IComparer<T> 키를 비교 하는 데 사용할 구현입니다.Implementations can vary in how they determine equality of objects; for example, the List<T> class uses Comparer<T>.Default, whereas the Dictionary<TKey,TValue> class allows the user to specify the IComparer<T> implementation to use for comparing keys.

있습니다 수 있는지 여부에 따라 다양 한 구현이 key 되도록 null합니다.Implementations can vary in whether they allow key to be null.

적용 대상

추가 정보