WebTestContext.TryGetValue, méthode
Obtient la valeur associée à la clé spécifiée.
Espace de noms : Microsoft.VisualStudio.TestTools.WebTesting
Assembly : Microsoft.VisualStudio.QualityTools.WebTestFramework (dans Microsoft.VisualStudio.QualityTools.WebTestFramework.dll)
Syntaxe
'Déclaration
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
Paramètres
- key
Type : System.String
Clé à rechercher.
- value
Type : System.Object%
Objet référencé qui récupère la valeur de la clé si elle est trouvée ; sinon, il obtient la valeur par défaut pour le type du paramètre value.Ce paramètre peut être passé sans être initialisé.
Valeur de retour
Type : System.Boolean
true s'il contient un élément avec la clé spécifiée ; sinon, false.
Implémentations
IDictionary<TKey, TValue>.TryGetValue(TKey, TValue%)
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | key a la valeur nullune référence null (Nothing en Visual Basic). |
Notes
Le contexte défini par des variables d'environnement ou un test de charge substituera l'élément retourné par cette propriété.Donc, si un test de performances Web s'exécute dans un test de charge qui contient un contexte appelé « myContext », un appel à MyWebTestContext.TryGetValue("myContext", MyObject) retournera la valeur pour LoadTestContext.Item("myContext", MyObject).
C'est la méthode la plus efficace pour essayer de récupérer des valeurs si plusieurs clés testées ne sont pas dans le dictionnaire.Cette méthode combine la fonctionnalité de la méthode ContainsKey et de la propriété Item.
Si key est introuvable, le paramètre outvalue reçoit la valeur par défaut appropriée : zéro pour les types entiers, false pour les types booléens et nullune référence null (Nothing en Visual Basic) pour les types référence.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.