HttpWebRequest.Host Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
İ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, setPublic Property Host As StringÖzellik Değeri
HTTP isteğindeki Konak üst bilgisi değeri.
Özel durumlar
Konak üst bilgisi nullolarak ayarlanamaz.
Konak üst bilgisi geçersiz bir değere ayarlanamaz.
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.
