WwwFormUrlDecoder.GetFirstValueByName(String) Método

Definición

Espacio de nombres:

Windows.Foundation

Obtiene el primer par nombre-valor que tiene el nombre especificado, tal como se obtiene de la cadena de consulta identificador uniforme de recursos (URI).

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

Nombre del valor que se va a obtener.

Devoluciones

String

Platform::String

winrt::hstring

Primer valor en el orden de lista que corresponde con el nombre.

Comentarios

Este método produce una excepción (un error para JavaScript) si el valor especificado como nombre no existe en la colección WwwFormUrlDecoder . Para el código .NET, se escribe como System.ArgumentException. Probablemente querrá llamar a GetFirstValueByName dentro de un bloque try-catch para que tenga la oportunidad de controlar la excepción.

Lo que se debe hacer con nombres duplicados en una cadena de consulta de una solicitud GET no se especifica mediante ningún estándar de Internet. Una práctica habitual es procesar el primer valor e ignorar los duplicados posteriores. El método GetFirstValueByName proporciona ese comportamiento. También proporciona el comportamiento de "índice por cadena" de facto, que suele ser lo que se desea cuando se procesa una cadena de consulta. La aplicación espera que ciertos nombres estén presentes en la cadena de consulta y quiere recuperar el valor asociado.