HttpWebRequest.Host Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Requests.dll

Sumber:

HttpWebRequest.cs

Mendapatkan atau mengatur nilai header Host untuk digunakan dalam permintaan HTTP yang independen dari URI permintaan.

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };

public string Host { get; set; }

member this.Host : string with get, set

Public Property Host As String

Nilai Properti

String

Nilai header Host dalam permintaan HTTP.

Pengecualian

ArgumentNullException

Header Host tidak dapat diatur ke null.

ArgumentException

Header Host tidak dapat diatur ke nilai yang tidak valid.

InvalidOperationException

Header Host tidak dapat diatur setelah HttpWebRequest sudah mulai dikirim.

Keterangan

Properti Host dapat digunakan untuk mengatur nilai header Host untuk digunakan dalam permintaan HTTP independen dari URI permintaan. Host Properti dapat terdiri dari nama host dan nomor port opsional. Header Host tanpa informasi port menyiratkan port default untuk layanan yang diminta (port 80 untuk URL HTTP, misalnya).

Format untuk menentukan host dan port harus mengikuti aturan di bagian 14.23 RFC2616 yang diterbitkan oleh IETF. Contoh yang mematuhi persyaratan ini yang menentukan port 8080 akan menjadi nilai berikut untuk Host properti :

www.contoso.com:8080

Host Menggunakan properti untuk secara eksplisit menentukan nilai header Host kustom juga memengaruhi penembolokan area, cookie, dan autentikasi. Ketika aplikasi menyediakan kredensial untuk awalan URI tertentu, aplikasi perlu memastikan untuk menggunakan URI yang berisi nilai header Host, bukan server target di URI. Kunci yang digunakan saat penembolokan sumber daya, menggunakan nilai header Host daripada URI permintaan. Cookie disimpan dalam dan secara logis dikelompokkan CookieContainer menurut nama domain server. Jika aplikasi menentukan header Host, maka nilai ini akan digunakan sebagai domain.

Host Jika properti tidak diatur, maka nilai header Host yang akan digunakan dalam permintaan HTTP didasarkan pada URI permintaan.