LoadTestUserContext.Add 方法 (String, Object)

2013-05-20

将具有所提供键和值的元素添加到 LoadTestUserContext。

命名空间： Microsoft.VisualStudio.TestTools.LoadTesting
程序集： Microsoft.VisualStudio.QualityTools.LoadTestFramework（在 Microsoft.VisualStudio.QualityTools.LoadTestFramework.dll 中）

语法

声明
Public Sub Add ( _
    key As String, _
    value As Object _
)

public void Add(
    string key,
    Object value
)

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

abstract Add : 
        key:string * 
        value:Object -> unit 
override Add : 
        key:string * 
        value:Object -> unit

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

参数

key
类型：System.String
作为要添加的元素的键的唯一标识符。

value
类型：System.Object
作为要添加的元素的值的对象。

实现

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

异常

异常	条件
ArgumentNullException	key 为 nullnull 引用（在 Visual Basic 中为 Nothing）。
ArgumentException	LoadTestUserContext 中已存在具有同一 key 的元素。
NotSupportedException	LoadTestUserContext 为只读。

备注

还可以使用 Item 属性来添加新元素，方法是设置某个键的值，该值不在 LoadTestUserContext 中，例如，myLoadTestUserContext["myNonexistentKey"] = myValue。但是，如果指定的键已经位于 LoadTestUserContext 中，则设置 Item 属性将覆盖旧值。比较起来，Add 方法不修改现有元素。

key 不能为 nullnull 引用（在 Visual Basic 中为 Nothing），但如果 value 为引用类型，则 value 可以为 nullnull 引用（在 Visual Basic 中为 Nothing）。