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 nullolarak ayarlanamaz.

ArgumentException

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

InvalidOperationException

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

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Host özelliği, 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ından 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, Host özelliği için aşağıdaki değer olacaktır:

www.contoso.com:8080

Özel bir Konak üst bilgisi değerini açıkça belirtmek için Host ö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 sunucu yerine Konak üst bilgisinin değerini içeren URI'yi kullandığından emin olması gerekir. Kaynakları önbelleğe alırken kullanılan anahtar, istek URI'sinin yerine Konak üst bilgi değerini kullanır. Tanımlama bilgileri bir CookieContainer 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 özelliği ayarlanmadıysa, HTTP isteğinde kullanılacak Konak üst bilgi değeri istek URI'sini temel alır.