WwwFormUrlDecoder.GetFirstValueByName(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 StringParamètres
- name
-
String
Platform::String
winrt::hstring
Nom de la valeur à obtenir.
Retours
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.