WwwFormUrlDecoder Kelas

Definisi

Ruang nama:

Windows.Foundation

Mengurai string kueri URL, dan mengekspos hasilnya sebagai vektor baca-saja (daftar) pasangan nama-nilai dari string kueri.

public ref class WwwFormUrlDecoder sealed : IIterable<IWwwFormUrlDecoderEntry ^>, IVectorView<IWwwFormUrlDecoderEntry ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.IWwwFormUrlDecoderRuntimeClassFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WwwFormUrlDecoder final : IIterable<IWwwFormUrlDecoderEntry>, IVectorView<IWwwFormUrlDecoderEntry>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.IWwwFormUrlDecoderRuntimeClassFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WwwFormUrlDecoder : IEnumerable<IWwwFormUrlDecoderEntry>, IReadOnlyList<IWwwFormUrlDecoderEntry>

function WwwFormUrlDecoder(query)

Public NotInheritable Class WwwFormUrlDecoder
Implements IEnumerable(Of IWwwFormUrlDecoderEntry), IReadOnlyList(Of IWwwFormUrlDecoderEntry)

Warisan

Object Platform::Object IInspectable WwwFormUrlDecoder

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IIterable<T> IEnumerable<T> IIterable<IWwwFormUrlDecoderEntry> IEnumerable<IWwwFormUrlDecoderEntry> IVectorView<IWwwFormUrlDecoderEntry> IReadOnlyList<IWwwFormUrlDecoderEntry>

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Gunakan kelas WwwFormUrlDecoder untuk mengurai string kueri ke dalam pasangan nama-nilai, berdasarkan jumlah dan penempatan simbol "&" dan "=". Setiap pasangan nama-nilai diwakili oleh objek IWwwFormUrlDecoderEntry , yang memiliki properti Nama dan properti Nilai (kedua string).

Gunakan GetFirstValueByName untuk menemukan parameter string kueri bernama tertentu. Semua bahasa dapat menggunakan metode ini. Anda biasanya menggunakan GetFirstValueByName daripada GetAt karena urutan item dalam string kueri biasanya tidak penting, sedangkan nama parameter adalah pengidentifikasi penting dari bagian kueri. Atau, jika Anda tidak yakin nama apa yang ada dalam string kueri, Anda mungkin menghitung koleksi WwwFormUrlDecoder lengkap.

Properti Uri.QueryParsed mengembalikan WwwFormUrlDecoder lengkap berdasarkan instans Uri . Jadi, jika Anda menggunakan ekstensi komponen Visual C++ (C++/CX) atau kode JavaScript, dan Anda sudah memiliki instans Uri , Anda tidak perlu membuat objek WwwFormUrlDecoder baru, instans Uri sudah memilikinya. Anda dapat membuat WwwFormUrlDecoder jika Anda memiliki string yang mewakili URL atau komponen string kuerinya dari sumber lain, seperti dari API Windows.Web.Http .

Catatan

Koleksi ini adalah vektor daripada peta jika urutan asli memiliki arti untuk implementasi, dan juga karena legal untuk nama yang sama muncul dalam string kueri dua kali, sedangkan tidak legal bagi peta untuk memiliki kunci duplikat.

Daftar anggota koleksi

Untuk penggunaan .NET, WwwFormUrlDecoder memiliki API yang diproyeksikan dari IReadOnlyList generik dengan batasan IWwwFormUrlDecoderEntry . API yang tersedia untuk setiap bahasa ditunjukkan dalam daftar anggota.

Untuk JavaScript, WwwFormUrlDecoder memiliki anggota yang ditampilkan dalam daftar anggota. Selain itu, WwwFormUrlDecoder mendukung properti panjang , anggota Array.prototype, dan menggunakan indeks untuk mengakses item.

Penggunaan .NET

Kode .NET tidak dapat menggunakan kelas Windows.Foundation.Uri (Anda menggunakan System.Uri sebagai gantinya). Tetapi kode .NET dapat dan harus menggunakan WwwFormUrlDecoder. Menggunakan WwwFormUrlDecoder lebih sederhana dan kurang rawan kesalahan daripada pemisahan string pada karakter "&" dan "=". Itu menjadi rumit karena pengodean. Untuk menggunakan WwwFormUrlDecoder, panggil konstruktor WwwFormUrlDecoder , meneruskan nilai Kueri dari System.Uri Anda. Ini menginisialisasi objek WwwFormUrlDecoder baru. Kemudian gunakan GetFirstValueByName untuk menemukan parameter string kueri bernama tertentu. Atau, jika Anda tidak tahu apa yang akan ada dalam string kueri, hitung koleksi untuk menentukan parameter string kueri yang tersedia.

Gunakan antarmuka IWwwFormUrlDecoderEntry untuk jenis item dalam koleksi (ini adalah cara item di ketikkan oleh IndexOf). Jangan gunakan kelas WwwFormUrlDecoderEntry , kelas ini tidak tersedia untuk penggunaan .NET.

WwwFormUrlDecoder juga memiliki API yang diproyeksikan dari IReadOnlyList generik dengan batasan IWwwFormUrlDecoderEntry , tetapi API ini tidak umum digunakan.

Catatan

System.Web.HttpUtility.ParseQueryString tidak tersedia untuk aplikasi .NET untuk Windows Runtime. WwwFormUrlDecoder adalah pengganti yang direkomendasikan untuk itu.

Menghitung koleksi di C# atau Microsoft Visual Basic

WwwFormUrlDecoder dapat dijumlahkan, sehingga Anda dapat menggunakan sintaks khusus bahasa seperti foreach di C# untuk menghitung item dalam koleksi. Pengkompilasi melakukan pengecoran jenis untuk Anda dan Anda tidak perlu mentransmisian secara IEnumerable<IWwwFormUrlDecoderEntry> eksplisit. Jika Anda perlu mentransmisikan secara eksplisit, misalnya jika Anda ingin memanggil GetEnumerator, transmisikan ke IEnumerable<T> dengan batasan IWwwFormUrlDecoderEntry .

Konstruktor

WwwFormUrlDecoder(String)

Membuat dan menginisialisasi instans baru kelas WwwFormUrlDecoder .

Properti

Size	Mendapatkan jumlah pasangan nama-nilai dalam string kueri URL saat ini.

Metode

First()	Mendapatkan iterator yang mewakili pasangan nama-nilai pertama dalam string kueri URL saat ini.
GetAt(UInt32)	Mendapatkan pasangan nama-nilai pada indeks yang ditentukan dalam string kueri URL saat ini.
GetFirstValueByName(String)	Mendapatkan pasangan nama-nilai pertama yang memiliki nama yang ditentukan, seperti yang diperoleh dari string kueri Pengidentifikasi Sumber Daya Seragam (URI) konstruksi.
GetMany(UInt32, IWwwFormUrlDecoderEntry[])	Mendapatkan pasangan nama-nilai yang dimulai pada indeks yang ditentukan dalam string kueri URL saat ini.
IndexOf(IWwwFormUrlDecoderEntry, UInt32)	Mendapatkan nilai yang menunjukkan apakah IWwwFormUrlDecoderEntry yang ditentukan berada pada indeks yang ditentukan dalam string kueri URL saat ini.

Lihat juga

• IWwwFormUrlDecoderEntry
• QueryParsed