WwwFormUrlDecoder.GetFirstValueByName(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém o primeiro par nome-valor que tem o nome especificado, conforme obtido da cadeia de caracteres de consulta URI (Uniform Resource Identifier) de construção.
public:
virtual Platform::String ^ GetFirstValueByName(Platform::String ^ name) = GetFirstValueByName;
winrt::hstring GetFirstValueByName(winrt::hstring const& name);
public string GetFirstValueByName(string name);
function getFirstValueByName(name)
Public Function GetFirstValueByName (name As String) As String
Parâmetros
- name
-
String
Platform::String
winrt::hstring
O nome do valor a ser obtido.
Retornos
O primeiro valor na ordem de lista que corresponde ao nome.
Comentários
Esse método gerará uma exceção (um erro para JavaScript) se o valor especificado como name não existir na coleção WwwFormUrlDecoder . Para o código .NET, isso é digitado como System.ArgumentException. Você provavelmente desejará chamar GetFirstValueByName em um bloco try-catch para que tenha a chance de lidar com a exceção.
O que fazer com nomes duplicados em uma cadeia de caracteres de consulta de uma solicitação GET não é especificado por nenhum padrão da Internet. Uma prática comum é processar o primeiro valor e ignorar as duplicatas subsequentes. O método GetFirstValueByName fornece esse comportamento. Ele também fornece o comportamento de fato "índice por cadeia de caracteres", que normalmente é o que você deseja ao processar uma cadeia de caracteres de consulta. Seu aplicativo espera que determinados nomes estejam presentes na cadeia de caracteres de consulta e deseja recuperar o valor associado.