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 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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Properti Host dapat digunakan untuk mengatur nilai header Host untuk digunakan dalam permintaan HTTP independen dari URI permintaan. Properti Host 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 diterbitkan oleh IETF. Contoh yang mematuhi persyaratan ini yang menentukan port 8080 akan menjadi nilai berikut untuk properti Host:

www.contoso.com:8080

Menggunakan properti Host 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 CookieContainer dan dikelompokkan secara logis berdasarkan nama domain server. Jika aplikasi menentukan header Host, maka nilai ini akan digunakan sebagai domain.

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