WwwFormUrlDecoder.GetFirstValueByName(String) Méthode

Définition

Espace de noms:

Windows.Foundation

Obtient la paire prénom-valeur qui a le nom spécifié, comme obtenu à partir de la chaîne de requête URI (Uniform Resource Identifier) de construction.

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

Paramètres

name

String

Platform::String

winrt::hstring

Nom de la valeur à obtenir.

Retours

String

Platform::String

winrt::hstring

Première valeur dans l’ordre de liste qui correspond à name.

Remarques

Cette méthode lève une exception (erreur pour JavaScript) si la valeur spécifiée en tant que nom n’existe pas dans la collection WwwFormUrlDecoder . Pour le code .NET, il est tapé en tant que System.ArgumentException. Vous voudrez probablement appeler GetFirstValueByName dans un bloc try-catch afin de pouvoir gérer l’exception.

La procédure à suivre avec les noms en double dans une chaîne de requête à partir d’une requête GET n’est spécifiée par aucune norme Internet. Une pratique courante consiste à traiter la première valeur et à ignorer les doublons suivants. La méthode GetFirstValueByName fournit ce comportement. Il fournit également le comportement « index par chaîne » de facto, qui correspond généralement à ce que vous souhaitez lorsque vous traitez une chaîne de requête. Votre application s’attend à ce que certains noms soient présents sur la chaîne de requête et souhaite récupérer la valeur associée.