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 bilgisi 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 Konak ü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 hizmetin varsayılan bağlantı noktasını (örneğin, bir HTTP URL'si için 80 numaralı bağlantı noktası) gösterir.

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 gereksinimlere uygun bir örnek, özelliği için Host aşağıdaki değer olabilir:

www.contoso.com:8080

Host Özel bir Konak üst bilgisi değerini açıkça belirtmek için özelliğinin kullanılması, alanların önbelleğe alınmasını, tanımlama bilgilerini ve kimlik doğrulaması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'si yerine Konak üst bilgisi değerini kullanır. Tanımlama bilgileri, sunucu etki alanı adına göre mantıksal olarak gruplandırılmış bir CookieContainer ve içinde depolanı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 bilgisi değeri istek URI'sini temel alır.