HttpListenerElement.UnescapeRequestUrl Özellik

Tanım

Ad Alanı:

System.Net.Configuration

Bütünleştirilmiş Kod:

System.dll

Dönüştürülen URI yerine ayrılmış ham URI'yi kullanıp kullanmadığını belirten HttpListener bir değer alır.

public:
 property bool UnescapeRequestUrl { bool get(); };

[System.Configuration.ConfigurationProperty("unescapeRequestUrl", DefaultValue=true, IsRequired=false)]
public bool UnescapeRequestUrl { get; }

[<System.Configuration.ConfigurationProperty("unescapeRequestUrl", DefaultValue=true, IsRequired=false)>]
member this.UnescapeRequestUrl : bool

Public ReadOnly Property UnescapeRequestUrl As Boolean

Özellik Değeri

Boolean

Dönüştürülen URI yerine, günah çıkarılmamış ham URI'yi kullanıp kullanmadığını gösteren HttpListener bir Boole değeri.

Öznitelikler

ConfigurationPropertyAttribute

Açıklamalar

özelliği, UnescapeRequestUrl yüzde kodlamalı değerlerin dönüştürüldüğü ve diğer normalleştirme adımlarının atıldığı dönüştürülmüş URI yerine ham ayarlanmamış URI'nin kullanılıp kullanılmadığını gösterir HttpListener .

Bir HttpListener örnek hizmet aracılığıyla http.sys bir istek aldığında, tarafından http.syssağlanan URI dizesinin bir örneğini oluşturur ve özelliği olarak HttpListenerRequest.Url kullanıma sunar.

Hizmet iki http.sys istek URI dizesini kullanıma sunar:

• Ham URI

• Dönüştürülen URI

Ham URI, bir HTTP isteğinin istek satırında sağlanan URI'dir System.Uri :

GET /path/

Host: www.contoso.com

Yukarıda bahsedilen istek için tarafından http.sys sağlanan ham URI "/path/" şeklindedir. Bu, ağ üzerinden gönderilen HTTP fiilinden sonraki dizeyi temsil eder.

Hizmet, http.sys isteğin iletilmesi gereken kaynak sunucuyu belirlemek için HTTP istek satırında ve Konak üst bilgisinde sağlanan URI'yi kullanarak istekte sağlanan bilgilerden dönüştürülmüş bir URI oluşturur. Bu, istekten alınan bilgiler bir dizi kayıtlı URI ön eki ile karşılaştırılarak gerçekleştirilir. HTTP Server SDK belgeleri, bu dönüştürülmüş URI'yi HTTP_COOKED_URL yapısı olarak ifade eder.

İsteği kayıtlı URI ön ekleriyle karşılaştırabilmek için istekte bazı normalleştirmelerin yapılması gerekir. Yukarıdaki örnek için dönüştürülen URI aşağıdaki gibi olacaktır:

http://www.contoso.com/path/

Hizmet, http.sys dönüştürülmüş bir URI oluşturmak için özellik değerini ve istek satırındaki dizeyi birleştirir Uri.Host . Ayrıca ve http.sysSystem.Uri sınıfı da aşağıdakileri yapar:

• Kodlanmış yüzde değerlerinin tümünün kaçışı kaldırılır.

• Yüzde kodlamalı ASCII olmayan karakterleri UTF-16 karakter gösterimine dönüştürür. UTF-8 ve ANSI/DBCS karakterlerinin yanı sıra Unicode karakterlerinin de (%uXXXX biçimini kullanan Unicode kodlama) desteklendiğini unutmayın.

• Yol sıkıştırma gibi diğer normalleştirme adımlarını yürütür.

İstek, yüzde kodlamalı değerler için kullanılan kodlama hakkında herhangi bir bilgi içermediğinden, yalnızca yüzde kodlamalı değerleri ayrıştırarak doğru kodlamayı belirlemek mümkün olmayabilir.

Bu nedenle http.sys , işlemi değiştirmek için iki kayıt defteri anahtarı sağlar:

Kayıt Defteri Anahtarı	Varsayılan değer	Description
EnableNonUTF8	1	Sıfır ise, http.sys yalnızca UTF-8 ile kodlanmış URL'leri kabul eder. Sıfır değilse, http.sys isteklerde ANSI kodlamalı veya DBCS ile kodlanmış URL'leri de kabul eder.
FavorUTF8	1	Sıfır olmayan bir URL'nin http.sys kodunu her zaman önce UTF-8 olarak çözmeyi dener; bu dönüştürme başarısız olursa ve EnableNonUTF8 sıfır değilse, Http.sys kodu ANSI veya DBCS olarak çözmeyi dener. Sıfırsa (ve EnableNonUTF8 sıfır değilse), http.sys ansi veya DBCS olarak kodunu çözmeyi dener; başarılı olmazsa UTF-8 dönüştürmesi dener.

HttpListener bir istek aldığında, özelliğine giriş olarak öğesinden http.sys dönüştürülen URI'yi Url kullanır.

URI'lerdeki karakterlerin ve sayıların yanı sıra destekleyici karakterlere de ihtiyaç vardır. "1/3812" müşteri numarasının müşteri bilgilerini almak için kullanılan aşağıdaki URI'ye örnek verilmiştir:

http://www.contoso.com/Customer('1%2F3812')/

Uri(%2F) içindeki yüzde kodlamalı eğik çizgiye dikkat edin. Bu durumda eğik çizgi karakteri bir yol sınırlayıcısı değil verileri temsil ettiğinden bu gereklidir.

Dizenin Uri oluşturucusunun geçirilmesi aşağıdaki URI'ye yol açar:

http://www.contoso.com/Customer('1/3812')/

Yolun kendi kesimlerine bölünmesi aşağıdaki öğelere neden olur:

Customer('1

3812')

Bu, isteği gönderenin amacı değildir.

UnescapeRequestUrl Özellik false olarak ayarlanırsa, isteği aldığında HttpListener özelliğine giriş olarak dönüştürülen URI yerine ham URI'yi http.sysUrl kullanır.

Ayrıca bkz.

• HttpListener
• Url
• Ağ Ayarları Şeması
• <httpListener> Öğesi (Ağ Ayarları)