WebTestContext.TryGetValue-Methode
Ruft den dem angegebenen Schlüssel zugeordneten Wert ab.
Namespace: Microsoft.VisualStudio.TestTools.WebTesting
Assembly: Microsoft.VisualStudio.QualityTools.WebTestFramework (in Microsoft.VisualStudio.QualityTools.WebTestFramework.dll)
Syntax
'Declaration
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
Parameter
- key
Typ: System.String
Der zu suchende Schlüssel.
- value
Typ: System.Object%
Das Objekt, auf das verwiesen wird und das den Wert des Schlüssels abruft, sofern dieser vorhanden ist. Andernfalls wird der Standardwert für den Typ des value-Parameters übergeben.Dieser Parameter muss beim Übergeben nicht initialisiert sein.
Rückgabewert
Typ: System.Boolean
true, wenn ein Element mit dem angegebenen Schlüssel enthalten ist, andernfalls false.
Implementiert
IDictionary<TKey, TValue>.TryGetValue(TKey, TValue%)
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | key hat den Wert nullNULL-Verweis (Nothing in Visual Basic). |
Hinweise
Durch Umgebungsvariablen oder einen Auslastungstest definierter Kontext überschreibt das von dieser Eigenschaft zurückgegebene Element. Wenn also ein Webleistungstest in einem Auslastungstest ausgeführt wird, der einen Kontext mit dem Namen "myContext" enthält, wird durch einen Aufruf von MyWebTestContext.TryGetValue("myContext", MyObject) der Wert für LoadTestContext.Item("myContext", MyObject) zurückgegeben.
Dies ist die effizienteste Weise zum Abrufen von Werten, wenn einige getestete Schlüssel sich nicht im Wörterbuch befinden. Diese Methode kombiniert die Funktionalität der ContainsKey-Methode mit der Item-Eigenschaft.
Wenn key nicht gefunden wird, erhält der out value-Parameter den entsprechenden Standardwert: null (0) bei ganzen Zahlen, false bei booleschen Werten und nullNULL-Verweis (Nothing in Visual Basic) bei Verweistypen.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.