<schemeSettings> 項目 (Uri 設定)

發行項
08/12/2011

指定如何針對特定配置剖析 Uri。

<schemeSettings> 
</schemeSettings>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

無

子項目

項目	描述
<add>	加入結構描述名稱的結構描述設定。
<clear>	清除所有現有的結構描述設定。
<remove>	移除結構描述名稱的結構描述設定。

父項目

項目	描述
<uri>	內含設定，指定 .NET Framework 如何處理使用統一資源識別元 (URI) 表示的網址。

備註

根據預設，System.Uri 類別會在執行路徑壓縮前，取消逸出百分比編碼路徑分隔符號。這會實作為安全機制，以防禦下列攻擊：

https://www.contoso.com/.. %2F.. %2F/Windows/System32/cmd.exe?/c+dir+c:\

如果此 URI 傳遞到未正確處理百分比編碼字元的模組，可能會導致伺服器執行下列命令：

c:\Windows\System32\cmd.exe /c dir c:\

因此，System.Uri 類別會先取消逸出路徑分隔符號，然後再套用路徑壓縮。將惡意 URL 傳遞至 System.Uri 類別建構函式的結果，會產生下列 URI：

https://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\\

可以使用特定結構描述的 schemeSettings 組態選項，將這個預設行為修改為不取消逸出百分比編碼路徑分隔符號。

組態檔

這個項目可以用於應用程式組態檔或電腦組態檔 (Machine.config)。

範例

下列程式碼範例示範 Uri 類別所使用的組態，該組態支援不逸出的 HTTP 結構描述的百分比編碼路徑分隔符號。

<configuration>
  <uri>
    <schemeSettings>
      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>
    </schemeSettings>
  </uri>
</configuration>