WwwFormUrlDecoder.GetFirstValueByName(String) Метод

Определение

Пространство имен:

Windows.Foundation

Возвращает первую пару "имя-значение", которая имеет указанное имя, полученное из строки запроса 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

Параметры

name

String

Platform::String

winrt::hstring

Имя получаемого значения.

Возвращаемое значение

String

Platform::String

winrt::hstring

Первое значение в порядке списка, соответствующее имени.

Комментарии

Этот метод создает исключение (ошибку для JavaScript), если значение, указанное в качестве имени, не существует в коллекции WwwFormUrlDecoder . Для кода .NET это тип System.ArgumentException. Вероятно, вы захотите вызвать GetFirstValueByName в блоке try-catch , чтобы иметь возможность обработать исключение.

Что делать с повторяющимися именами в строке запроса из запроса GET, не указано ни в одном стандарте Интернета. Распространенной практикой является обработка первого значения и пропуск последующих дубликатов. Это поведение обеспечивает метод GetFirstValueByName. Он также обеспечивает де-факто поведение "индексировать по строке", которое обычно требуется при обработке строки запроса. Ваше приложение ожидает, что определенные имена будут присутствовать в строке запроса, и хочет получить связанное значение.