WwwFormUrlDecoder.GetFirstValueByName(String) Metodo

Definizione

Spazio dei nomi:

Windows.Foundation

Ottiene la prima coppia nome-valore con il nome specificato, come ottenuto dalla stringa di query URI (Uniform Resource Identifier).

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

Parametri

name

String

Platform::String

winrt::hstring

Nome del valore da ottenere.

Restituisce

String

Platform::String

winrt::hstring

Primo valore nell'ordine di elenco corrispondente al nome.

Commenti

Questo metodo genera un'eccezione (errore per JavaScript) se il valore specificato come nome non esiste nell'insieme WwwFormUrlDecoder . Per il codice .NET, viene digitato come System.ArgumentException. Probabilmente si vuole chiamare GetFirstValueByName all'interno di un blocco try-catch in modo da poter gestire l'eccezione.

Cosa fare con i nomi duplicati in una stringa di query da una richiesta GET non è specificato da uno standard Internet. Una procedura comune consiste nell'elaborare il primo valore e ignorare i duplicati successivi. Il metodo GetFirstValueByName fornisce tale comportamento. Fornisce anche il comportamento "indice per stringa", che è in genere quello che si vuole quando si elabora una stringa di query. L'app prevede la presenza di determinati nomi nella stringa di query e vuole recuperare il valore associato.