HttpBaseProtocolFilter Kelas

Definisi

Ruang nama:

Windows.Web.Http.Filters

Filter protokol dasar untuk instans HttpClient .

public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter

/// [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.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, IHttpFilter

Warisan

Object Platform::Object IInspectable HttpBaseProtocolFilter

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable IHttpFilter

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.

Lihat juga

• IClosable
• IHttpFilter