내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

IDictionary.Add 메서드

2013-12-13

제공된 키와 값을 가진 요소를 IDictionary 개체에 추가합니다.

Namespace:  System.Collections
어셈블리:  mscorlib(mscorlib.dll)

void Add(
	Object key,
	Object value
)

매개 변수

key
형식: System.Object
추가할 요소의 키로 사용할 Object입니다.
value
형식: System.Object
추가할 요소의 값으로 사용할 Object입니다.

예외조건
ArgumentNullException

keynull인 경우

ArgumentException

같은 키를 가진 요소가 이미 IDictionary 개체에 있는 경우

NotSupportedException

IDictionary가 읽기 전용인 경우

-또는-

IDictionary의 크기가 고정되어 있는 경우

또한 Item 속성을 사용하면 myCollection["myNonexistentKey"] = myValue와 같이 사전에 없는 키의 값을 설정하여 새 요소를 추가할 수도 있습니다. 그러나 지정한 키가 이미 사전에 있으면 Item 속성을 설정하면 이전 값을 덮어쓰게 됩니다. 이와는 반대로 Add 메서드는 기존 요소를 수정하지 않습니다.

키가 null일 수 있는지 여부에 따라 다른 구현이 가능합니다.

다음 코드 예제에서는 Add 메서드를 구현하는 방법을 보여 줍니다. 이 코드 예제는 IDictionary 클래스에 대해 제공되는 보다 큰 예제의 일부입니다.


public void Add(object key, object value)
{
   // Add the new key/value pair even if this key already exists in the dictionary.
   if (ItemsInUse == items.Length)
      throw new InvalidOperationException("The dictionary cannot hold any more items.");
   items[ItemsInUse++] = new DictionaryEntry(key, value);
}


Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시:
© 2015 Microsoft