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

列表顺序中与 name 相对应的第一个值。

注解

如果指定为名称的值在 WwwFormUrlDecoder 集合中不存在，此方法将引发异常 (JavaScript) 错误。 对于 .NET 代码，此类型为 System.ArgumentException。 你可能想要在 try-catch 块中调用 GetFirstValueByName，以便有机会处理异常。

对于 GET 请求中的查询字符串中重复名称的处理方式未由任何 Internet 标准指定。 常见做法是处理第一个值并忽略后续重复项。 GetFirstValueByName 方法提供该行为。 它还提供事实上的“按字符串编制索引”行为，这通常是在处理查询字符串时需要的行为。 你的应用希望查询字符串中存在某些名称，并且想要检索关联的值。