Método WebTestContext.TryGetValue
Obtém o valor associado com a chave especificada.
Namespace: Microsoft.VisualStudio.TestTools.WebTesting
Assembly: Microsoft.VisualStudio.QualityTools.WebTestFramework (em Microsoft.VisualStudio.QualityTools.WebTestFramework.dll)
Sintaxe
'Declaração
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
Parâmetros
- key
Tipo: System.String
A chave para encontrar.
- value
Tipo: System.Object%
O objeto referenciado que recupera o valor da chave, se for encontrada; Caso contrário, ele recupera o valor padrão para o tipo da value parâmetro.Este parâmetro pode ser transmitido não inicializado.
Valor de retorno
Tipo: System.Boolean
true Se ele contiver um elemento com a chave especificada; Caso contrário, false.
Implementações
IDictionary<TKey, TValue>.TryGetValue(TKey, TValue%)
Exceções
| Exceção | Condição |
|---|---|
| ArgumentNullException | key é nulluma referência nula (Nothing no Visual Basic). |
Comentários
Contexto definido por variáveis ambientais ou um teste de carga irá substituir o item retornado por essa propriedade. Portanto, se um teste de desempenho da Web está sendo executado em um teste de carga que contém um contexto chamado "myContext", uma chamada para MyWebTestContext.TryGetValue("myContext", MyObject) retornará o valor para o LoadTestContext.Item("myContext", MyObject).
Esta é a maneira mais eficiente para tentar recuperar os valores se várias chaves experimentadas não estão no dicionário. Esse método combina a funcionalidade da ContainsKey método e a Item propriedade.
Se a key não for encontrado, o out value parâmetro recebe o valor padrão apropriado: zero para tipos de inteiros, false para booleanos tipos, e nulluma referência nula (Nothing no Visual Basic) para tipos de referência.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.