WwwFormUrlDecoder.GetFirstValueByName(String) 메서드

정의

네임스페이스:

Windows.Foundation

URI(Uniform Resource Identifier) 쿼리 문자열을 생성하여 가져온 지정된 이름을 포함하는 이름-값 쌍을 가져옵니다.

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에 대한 오류)를 throw합니다. .NET 코드의 경우 System.ArgumentException으로 입력됩니다. 예외를 처리할 기회가 있도록 try-catch 블록 내에서 GetFirstValueByName을 호출하려고 할 수 있습니다.

GET 요청의 쿼리 문자열에서 중복된 이름으로 수행할 작업은 인터넷 표준에 의해 지정되지 않습니다. 일반적인 방법은 첫 번째 값을 처리하고 후속 중복을 무시하는 것입니다. GetFirstValueByName 메서드는 해당 동작을 제공합니다. 또한 쿼리 문자열을 처리할 때 일반적으로 원하는 "문자열별 인덱스" 동작을 사실상 제공합니다. 앱은 특정 이름이 쿼리 문자열에 있을 것으로 예상하며 연결된 값을 검색하려고 합니다.