获取与指定的键相关联的值。
命名空间: Microsoft.VisualStudio.TestTools.WebTesting
程序集: Microsoft.VisualStudio.QualityTools.WebTestFramework(在 Microsoft.VisualStudio.QualityTools.WebTestFramework.dll 中)
语法
声明
Public Function TryGetValue ( _
key As String, _
<OutAttribute> ByRef value As Object _
) As Boolean
public bool TryGetValue(
string key,
out Object value
)
public:
virtual bool TryGetValue(
String^ key,
[OutAttribute] Object^% value
) sealed
abstract TryGetValue :
key:string *
value:Object byref -> bool
override TryGetValue :
key:string *
value:Object byref -> bool
public final function TryGetValue(
key : String,
value : Object
) : boolean
参数
- key
类型:System.String
要查找的键。
- value
类型:System.Object%
如果找到该值,则为检索键的值的被应用对象;否则,它检索 value 参数的类型的默认值。此参数可在未经初始化的情况下进行传递。
返回值
类型:System.Boolean
如果它包含具有指定 key 的元素,则为 true;否则为 false。
实现
IDictionary<TKey, TValue>.TryGetValue(TKey, TValue%)
异常
异常 | 条件 |
---|---|
ArgumentNullException | key 为 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
备注
由环境变量或负载测试定义的上下文将重写此属性返回的项。 因此,如果 Web 性能测试正在包含名为“myContext”的上下文的负载测试中运行,则对 MyWebTestContext.TryGetValue("myContext", MyObject) 的调用将返回 LoadTestContext.Item("myContext", MyObject) 的值。
如果几个被尝试的键不在字典中,这将是尝试检索值的最有效方式。 此方法结合了 ContainsKey 方法和 Item 属性的功能。
如果找不到 key,则 outvalue 参数会获取相应的默认值:整数类型为零,布尔值类型为 false,引用类型为 nullnull 引用(在 Visual Basic 中为 Nothing)。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。