WwwFormUrlDecoder.GetFirstValueByName(String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan pasangan nama-nilai pertama yang memiliki nama yang ditentukan, seperti yang diperoleh dari string kueri Pengidentifikasi Sumber Daya Seragam (URI) konstruksi.
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
Parameter
- name
-
String
Platform::String
winrt::hstring
Nama nilai yang akan didapatkan.
Mengembalikan
Nilai pertama dalam urutan daftar yang sesuai dengan nama.
Keterangan
Metode ini memberikan pengecualian (kesalahan untuk JavaScript) jika nilai yang ditentukan sebagai nama tidak ada di koleksi WwwFormUrlDecoder . Untuk kode .NET, ini ditik sebagai System.ArgumentException. Anda mungkin ingin memanggil GetFirstValueByName dalam blok try-catch sehingga Anda memiliki kesempatan untuk menangani pengecualian.
Apa yang harus dilakukan dengan nama duplikat dalam string kueri dari permintaan GET tidak ditentukan oleh standar Internet apa pun. Praktik umum adalah memproses nilai pertama dan mengabaikan duplikat berikutnya. Metode GetFirstValueByName menyediakan perilaku tersebut. Ini juga menyediakan perilaku "indeks menurut string" de-facto, yang biasanya apa yang Anda inginkan saat Anda memproses string kueri. Aplikasi Anda mengharapkan nama tertentu ada pada string kueri, dan ingin mengambil nilai terkait.