Partilhar via


WwwFormUrlDecoder.GetFirstValueByName(String) Método

Definição

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

String

Platform::String

winrt::hstring

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.

Aplica-se a