LoadTestUserContext.Add - метод (String, Object)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Добавляет элемент, имеющий предоставленный ключ и значение, в объект LoadTestUserContext.

Пространство имен: Microsoft.VisualStudio.TestTools.LoadTesting
Сборка: Microsoft.VisualStudio.QualityTools.LoadTestFramework (в Microsoft.VisualStudio.QualityTools.LoadTestFramework.dll)

Синтаксис

'Декларация
Public Sub Add ( _
    key As String, _
    value As Object _
)
'Применение
Dim instance As LoadTestUserContext
Dim key As String
Dim value As Object

instance.Add(key, value)

public void Add(
    string key,
    Object value
)

public:
virtual void Add(
    String^ key, 
    Object^ value
) sealed

public final function Add(
    key : String, 
    value : Object
)

Параметры

key
Тип: System.String
Уникальный идентификатор, использующийся как ключ к добавляемому элементу.

value
Тип: System.Object
Объект, используемый в качестве значения добавляемого элемента.

Реализации

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

Исключения

Исключение	Условие
ArgumentNullException	Параметр key имеет значение nullссылка null (Nothing в Visual Basic).
ArgumentException	Элемент, имеющий такой же параметр key, уже существует в LoadTestUserContext.
NotSupportedException	Объект LoadTestUserContext доступен только для чтения.

Заметки

Для добавления новых элементов можно также использовать свойство Item, задавая значение ключа, не существующего в LoadTestUserContext, например, myLoadTestUserContext["myNonexistentKey"] = myValue. Однако если указанный ключ уже существует в LoadTestUserContext, задание свойства Item приведет к перезаписи прежнего значения. Напротив, метод Add не изменяет существующие элементы.

key не может быть nullссылка null (Nothing в Visual Basic), но value может быть nullссылка null (Nothing в Visual Basic), если value имеет ссылочный тип.

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.