HttpBaseProtocolFilter Kelas
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.
Filter protokol dasar untuk instans HttpClient .
public ref class HttpBaseProtocolFilter sealed : IClosable
public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpBaseProtocolFilter final : IClosable
/// [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(65536, "Windows.Foundation.UniversalApiContract")]
class HttpBaseProtocolFilter final : IClosable
/// [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(65536, "Windows.Foundation.UniversalApiContract")]
class HttpBaseProtocolFilter final : IClosable, IHttpFilter
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpBaseProtocolFilter : System.IDisposable
[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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBaseProtocolFilter : System.IDisposable
[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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBaseProtocolFilter : System.IDisposable, IHttpFilter
function HttpBaseProtocolFilter()
Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable
Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable, IHttpFilter
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Keterangan
Kelas HttpBaseProtocolFilter menyediakan filter dasar atau handler yang digunakan oleh instans HttpClient . Jika tidak ada filter tambahan yang ditambahkan ke instans HttpClient , maka objek HttpBaseProtocolFilter akan menjadi satu-satunya filter.
Kelas HttpBaseProtocolFilter menyediakan sekumpulan properti untuk mengalihkan berbagai perilaku tumpukan HTTP tingkat rendah.
Filter tambahan berdasarkan antarmuka IHttpFilter dapat ditambahkan ke rantai filter yang diterapkan ke instans HttpClient yang dapat menangani atau memproses hasil lebih lanjut dari objek HttpBaseProtocolFilter.
Objek HttpBaseProtocolFilter melemparkan pengecualian saat mengirim permintaan HTTP atau menerima respons dan kegagalan jaringan terjadi (hilangnya konektivitas dalam mode pesawat, misalnya). Pengembang yang menggunakan HttpClient di aplikasi mungkin lebih suka menambahkan filter untuk menangkap pengecualian ini dan mengonversinya ke kode respons HTTP sebagai gantinya.
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1511 | 10586 | CookieUsageBehavior |
1607 | 14393 | ClearAuthenticationCache |
1607 | 14393 | ServerCustomValidationRequested |
1903 | 18362 | CreateForUser |
1903 | 18362 | Pengguna |
Konstruktor
HttpBaseProtocolFilter() |
Menginisialisasi instans baru kelas HttpBaseProtocolFilter . Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow. |
Properti
AllowAutoRedirect |
Dapatkan atau tetapkan nilai yang menunjukkan apakah HttpBaseProtocolFilter harus mengikuti respons pengalihan. |
AllowUI |
Dapatkan atau tetapkan nilai yang menunjukkan apakah HttpBaseProtocolFilter dapat meminta kredensial pengguna saat diminta oleh server. |
AutomaticDecompression |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah HttpBaseProtocolFilter dapat secara otomatis mendekompresi respons konten HTTP. |
CacheControl |
Dapatkan atau atur perilaku kontrol cache baca dan tulis yang akan digunakan pada objek HttpBaseProtocolFilter . |
ClientCertificate |
Dapatkan atau atur sertifikat SSL klien yang akan dikirim ke server jika server meminta sertifikat klien. |
CookieManager |
Dapatkan HttpCookieManager dengan cookie yang terkait dengan aplikasi. |
CookieUsageBehavior |
Mendapatkan atau mengatur perilaku penggunaan cookie. Secara default, cookie ditangani secara otomatis. |
IgnorableServerCertificateErrors |
Dapatkan vektor kesalahan sertifikat server SSL yang kemudian dapat dipilih aplikasi untuk diabaikan. |
MaxConnectionsPerServer |
Dapatkan atau atur jumlah maksimum koneksi TCP yang diizinkan per server HTTP oleh objek HttpBaseProtocolFilter . |
MaxVersion |
Mendapatkan atau mengatur versi protokol HTTP yang digunakan. |
ProxyCredential |
Dapatkan atau atur kredensial yang akan digunakan untuk bernegosiasi dengan proksi HTTP. |
ServerCredential |
Dapatkan atau atur kredensial yang akan digunakan untuk mengautentikasi dengan server HTTP. |
UseProxy |
Dapatkan atau tetapkan nilai yang menunjukkan apakah HttpBaseProtocolFilter dapat menggunakan proksi untuk mengirim permintaan HTTP. |
User |
Mendapatkan Pengguna yang terkait dengan HttpBaseProtocolFilter. |
Metode
ClearAuthenticationCache() |
Menghapus kredensial autentikasi yang saat ini di-cache pada perangkat. |
Close() |
Menutup instans HttpBaseProtocolFilter dan merilis sumber daya yang dialokasikan. |
CreateForUser(User) |
Membuat HttpBaseProtocolFilter baru untuk Pengguna tertentu. |
Dispose() |
Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. |
SendRequestAsync(HttpRequestMessage) |
Kirim permintaan HTTP menggunakan HttpBaseProtocolFilter sebagai operasi asinkron. |
Acara
ServerCustomValidationRequested |
Kejadian ini dinaikkan ketika koneksi SSL/TLS sedang dibuat dengan server. Anda harus menerapkan penanganan aktivitas untuk peristiwa ini jika Anda perlu melakukan validasi tambahan (selain default OS) sertifikat SSL server. |