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

與 名稱對應的清單順序中的第一個值。

備註

如果 WwwFormUrlDecoder 集合中沒有指定為 name 的值，這個方法會擲回例外狀況 (JavaScript) 錯誤。 針對 .NET 程式碼，這會輸入為 System.ArgumentException。 您可能想要在 try-catch 區塊內呼叫 GetFirstValueByName，讓您有機會處理例外狀況。

任何網際網路標準都不會指定來自 GET 要求的查詢字串中重複名稱的動作。 常見的作法是處理第一個值，並忽略後續的重複專案。 GetFirstValueByName 方法會提供該行為。 它也提供「依字串編制索引」的行為，這通常是您在處理查詢字串時想要的行為。 您的應用程式預期查詢字串上有特定名稱，而且想要擷取相關聯的值。