HttpWebRequest.Host Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Requests.dll

Kaynak:

HttpWebRequest.cs

İstek URI'sinden bağımsız bir HTTP isteğinde kullanılacak Konak üst bilgi değerini alır veya ayarlar.

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

Özellik Değeri

String

HTTP isteğindeki Konak üst bilgi değeri.

Özel durumlar

ArgumentNullException

Konak üst bilgisi olarak nullayarlanamaz.

ArgumentException

Konak üst bilgisi geçersiz bir değere ayarlanamaz.

InvalidOperationException

Ana Bilgisayar üst bilgisi, gönderilmeye başladıktan sonra HttpWebRequest ayarlanamaz.

Açıklamalar

özelliği, Host istek URI'sinden bağımsız bir HTTP isteğinde kullanılacak Ana Bilgisayar üst bilgi değerini ayarlamak için kullanılabilir. Host özelliği bir konak adı ve isteğe bağlı bir bağlantı noktası numarasından oluşabilir. Bağlantı noktası bilgisi olmayan bir Konak üst bilgisi, istenen hizmet için varsayılan bağlantı noktasını gösterir (örneğin, bir HTTP URL'si için 80 numaralı bağlantı noktası).

Konak ve bağlantı noktası belirtme biçimi, IETF tarafından yayımlanan RFC2616 bölüm 14.23'teki kurallara uymalıdır. 8080 bağlantı noktasını belirten bu gereksinimlerle uyumlu bir örnek, özelliği için Host aşağıdaki değer olacaktır:

www.contoso.com:8080

Host Özel bir Konak üst bilgisi değerini açıkça belirtmek için özelliğinin kullanılması, önbelleğe alma, tanımlama bilgileri ve kimlik doğrulama alanlarını da etkiler. Bir uygulama belirli bir URI ön eki için kimlik bilgileri sağladığında, uygulamaların URI'deki hedef sunucuyu değil Konak üst bilgisinin değerini içeren URI'yi kullandığından emin olması gerekir. Kaynakları önbelleğe alırken kullanılan anahtar, istek URI'sini değil Konak üst bilgi değerini kullanır. Tanımlama bilgileri bir CookieContainer içinde depolanır ve sunucu etki alanı adına göre mantıksal olarak gruplandırılır. Uygulama bir Konak üst bilgisi belirtiyorsa, bu değer etki alanı olarak kullanılır.

Host Özellik ayarlanmadıysa, HTTP isteğinde kullanılacak Konak üst bilgi değeri istek URI'sini temel alır.