WebTestContext.TryGetValue メソッド
指定したキーに関連付けられている値を取得します。
名前空間: 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
指定されたキーを持つ要素が含まれている場合は true。それ以外の場合は false。
実装
IDictionary<TKey, TValue>.TryGetValue(TKey, TValue%)
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | key は nullnull 参照 (Visual Basic では Nothing) なので、 |
解説
環境変数またはロード テストで定義されたコンテキストは、このプロパティから返される項目をオーバーライドします。 このため、"myContext" という名前のコンテキストを含むロード テストで Web パフォーマンス テストを実行すると、MyWebTestContext.TryGetValue("myContext", MyObject) の呼び出しは LoadTestContext.Item("myContext", MyObject) の値を返します。
これは、試行される複数のキーがディクショナリ内に見つからなかった場合に値を取得するための最も効率的な方法です。 このメソッドは、ContainsKey メソッドと Item プロパティの機能を兼ね備えています。
key が見つからなかった場合、out value パラメーターは適切な既定値 (整数型についてはゼロ、ブール型については false、参照型については nullnull 参照 (Visual Basic では Nothing)) を受け取ります。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。