共用方式為

<iriParsing> 項目 (Uri Settings)

  • 發行項

更新：2007 年 11 月

指定是否要將國際資源識別項 (International Resource Identifiers，IRI) 剖析套用至 Uri，以及是否應該套用 IRI 剖析規則。

結構描述階層架構

<configuration> 項目

    <Uri> 項目 (Uri 設定)

        <iriParsing> 項目 (Uri Settings)

語法

<idn
  enabled="true|false"
/idn>

屬性和項目

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

屬性

項目

描述

enabled

指定是否啟用 IRI 剖析。預設值為 false。

子項目

無

父項目

項目

描述

URI

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

備註

現有的 Uri 類別已在 .NET Framework 3.5、3.0 SP1 和 2.0 SP1 中擴充，以提供國際資源識別項 (International Resource Identifiers，IRI) 和國際化網域名稱 (Internationalized Domain Names，IDN) 的支援。目前的使用者不會看到 .NET Framework 2.0 的行為變化，除非使用者指定啟用對 IRI 和 IDN 的支援。這可確保應用程式與舊版 .NET Framework 的相容性。

若要啟用 IRI 的支援，則需要進行下列兩項變更：

  1. 將下行加入 .NET Framework 2.0 目錄的 machine.config 檔案中

    <section name="uri" type="System.Configuration.UriSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />

  2. 指定是否要套用 IRI 剖析規則。這項變更可以在 machine.config 或 app.config 檔案中進行。

啟用 IRI 剖析 (iriParsing enabled = true) 會根據 RFC 3987 中最新的 IRI 規則執行正規化和字元檢查。預設值為 false，並且會根據 RFC 2396 和 RFC 3986 (適用於 IPv6 常值) 執行正規化和字元檢查。

組態檔

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

範例

描述

在下列程式碼範例中，會說明 Uri 類別用來支援 IRI 剖析和 IDN 名稱的組態。

程式碼

<configuration>
  <uri>
    <idn enabled="All" />
    <iriParsing enabled="true" />
  </uri>
</configuration>

請參閱

參考

網路設定結構描述

System.Configuration.IriParsingElement

System.Configuration.UriSection