WwwFormUrlDecoder.GetFirstValueByName(String) Methode

Definition

Namespace:

Windows.Foundation

Ruft das erste Name-Wert-Paar ab, das den angegebenen Namen hat, wie es von der URI-Abfragezeichenfolge (Uniform Resource Identifier) abgerufen wird.

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

Parameter

name

String

Platform::String

winrt::hstring

Der Name des abzurufenden Werts.

Gibt zurück

String

Platform::String

winrt::hstring

Der erste Wert in Listenreihenfolge, der dem Namen entspricht.

Hinweise

Diese Methode löst eine Ausnahme aus (ein Fehler für JavaScript), wenn der als Name angegebene Wert in der WwwFormUrlDecoder-Auflistung nicht vorhanden ist. Für .NET-Code wird dies als System.ArgumentException eingegeben. Wahrscheinlich möchten Sie GetFirstValueByName innerhalb eines try-catch-Blocks aufrufen, damit Sie die Ausnahme behandeln können.

Was mit doppelten Namen in einer Abfragezeichenfolge aus einer GET-Anforderung zu tun ist, wird von keinem Internetstandard angegeben. Eine gängige Praxis besteht darin, den ersten Wert zu verarbeiten und die nachfolgenden Duplikate zu ignorieren. Die GetFirstValueByName-Methode stellt dieses Verhalten bereit. Außerdem wird das De-facto-Verhalten "Index by String" bereitgestellt, das normalerweise bei der Verarbeitung einer Abfragezeichenfolge gewünscht wird. Ihre App erwartet, dass bestimmte Namen in der Abfragezeichenfolge vorhanden sind, und sie möchte den zugeordneten Wert abrufen.