WwwFormUrlDecoder.GetFirstValueByName(String) メソッド

定義

名前空間:

Windows.Foundation

作成する Uniform Resource Identifier (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

名前に対応するリスト順の最初の値。

注釈

名前として指定された値が WwwFormUrlDecoder コレクションに存在しない場合、このメソッドは例外 (JavaScript の場合はエラー) をスローします。 .NET コードの場合、これは System.ArgumentException として型指定されます。 例外を処理できるように、 try-catch ブロック内で GetFirstValueByName を呼び出す必要があります。

GET 要求からのクエリ文字列内の重複する名前に対する対処方法は、インターネット標準では指定されていません。 一般的な方法は、最初の値を処理し、後続の重複を無視することです。 GetFirstValueByName メソッドは、その動作を提供します。 また、事実上の "文字列によるインデックス" 動作も提供されます。これは通常、クエリ文字列を処理するときに必要な動作です。 アプリは、クエリ文字列に特定の名前が存在することを想定しており、関連付けられた値を取得したいと考えています。