WebRequest.RegisterPrefix(String, IWebRequestCreate) 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.
Mendaftarkan turunan WebRequest untuk URI yang ditentukan.
public:
static bool RegisterPrefix(System::String ^ prefix, System::Net::IWebRequestCreate ^ creator);
public static bool RegisterPrefix (string prefix, System.Net.IWebRequestCreate creator);
static member RegisterPrefix : string * System.Net.IWebRequestCreate -> bool
Public Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As Boolean
Parameter
- prefix
- String
Awalan URI atau URI lengkap yang WebRequest layanan turunan.
- creator
- IWebRequestCreate
Metode buat yang WebRequest panggil untuk membuat turunan WebRequest.
Mengembalikan
true
jika pendaftaran berhasil; jika tidak, false
.
Pengecualian
Keterangan
Hati
WebRequest
, HttpWebRequest
, ServicePoint
, dan WebClient
usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Metode RegisterPrefix mendaftarkan turunan WebRequest ke permintaan layanan. WebRequest turunan biasanya terdaftar untuk menangani protokol tertentu, seperti HTTP atau FTP, tetapi dapat didaftarkan untuk menangani permintaan ke server atau jalur tertentu di server.
Jenis cadangan yang telah didaftarkan sebelumnya meliputi yang berikut ini:
http://
https://
ftp://
file://
Untuk informasi selengkapnya, lihat metode Create(String) dan Create(Uri).
Awalan duplikat tidak diperbolehkan.
RegisterPrefix mengembalikan false
jika upaya dilakukan untuk mendaftarkan awalan duplikat.
Nota
Kelas HttpWebRequest didaftarkan ke permintaan layanan untuk skema HTTP dan HTTPS secara default. Upaya untuk mendaftarkan turunan WebRequest yang berbeda untuk skema ini akan gagal.