XmlReaderSettings.ConformanceLevel 屬性

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

取得或設定 XmlReader 要遵循的一致性層級。

public:
 property System::Xml::ConformanceLevel ConformanceLevel { System::Xml::ConformanceLevel get(); void set(System::Xml::ConformanceLevel value); };

public System.Xml.ConformanceLevel ConformanceLevel { get; set; }

member this.ConformanceLevel : System.Xml.ConformanceLevel with get, set

Public Property ConformanceLevel As ConformanceLevel

屬性值

ConformanceLevel

其中一個列舉值，指定 XML 讀取器將強制執行的一致性層級。 預設為 Document。

範例

下列範例會 XmlReader 建立讀取 XML 片段的物件。

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

備註

方法所 Create 建立的 XML 讀取器預設符合下列合規性需求：

• 新的行和屬性值會根據 W3C XML 1.0 建議正規化。

• 所有實體都會自動展開。

• 即使讀取器未驗證，也一律會新增在檔案類型定義中宣告的預設屬性。

• 允許對應至正確 XML 命名空間 URI 的 XML 前置詞宣告。

• 單 NotationType 一屬性宣告和 NmTokens 單 Enumeration 一屬性宣告中的標記法名稱是相異的。

您可以使用 ConformanceLevel 屬性來檢查並保證所讀取的資料流程符合格式正確的 XML 1.0 檔或檔片段的規則。 如果資料不符合規範， XmlException 則會擲回例外狀況。 預設值為 ConformanceLevel.Document 檔層級一致性 () 。

三個一致性層級如下：

設定	描述
Document	確保 XML 資料符合格式正確的 XML 1.0 檔規則。 此檢查層級可確保任何處理器都可以取用正在讀取的資料流程，做為 格式正確的 XML 1.0 檔。 讀取器會檢查下列項目： - 最上層專案不得具有 XML 宣告、檔案類型定義 (DTD) 、元素、批註、空白字元或處理指示以外的任何節點。 - XML 資料必須剛好有一個最上層元素節點。
Fragment	確保 XML 資料符合格式正確的 XML 1.0 檔片段規則。 此設定接受在最上層具有多個根項目或文字節點的 XML 資料。 此檢查層級可確保任何處理器都可以取用讀取為 外部剖析實體的資料流程。
Auto	指定讀取器應該根據傳入資料來判斷一致性檢查的層級。 如果 XML 資料包含 DTD 資訊，則會套用文件一致性檢查。 如果 XML 資料包含下列其中一項，則會套用片段一致性檢查： - 根層級的文字、CDATA 或實體參考節點。 - 根層級的多個元素。 - 根層級沒有元素。 如果存在衝突 (如根層級存在文字節點及 DTD)，則會擲回 XmlException。 當使用 Create 方法向現有 XmlReader 加入其他功能時，此設定可以用於包裝案例。 在此情況下， ConformanceLevel.Document 不會新增任何新的一致性檢查。 一致性檢查會留給被包裝的 XmlReader。

注意

存在 DTD 時，XML 1.0 版建議事項會要求文件層級的一致性。 因此，如果讀取器設定為支援 ConformanceLevel.Fragment ，但 XML 資料包含檔案類型定義 (DTD) ， XmlException 則會擲回 。

以下是讀取器處理特定一致性違規的方式，視 屬性的 ConformanceLevel 設定而定：

條件	Document	Fragment	Auto
文字或具類型的值會出現在最上層。	XmlException 擲回 。	此設定未被視為違規。	此設定未被視為違規。
多個元素或最上層未顯示任何元素。	XmlException 擲回 。	此設定未被視為違規。	此設定未被視為違規。
最上層專案是空白字元。	此設定未被視為違規。	此設定未被視為違規。	此設定未被視為違規。
最上層專案是 (辨識為文位元組點) 的屬性。	XmlException 擲回 。	此設定未被視為違規。	此設定未被視為違規。
找到多個連續的文字節點。	此設定未被視為違規。	此設定未被視為違規。	此設定未被視為違規。
相同的命名空間前置詞會在相同的本機範圍中宣告兩次。	XmlException 擲回 。	XmlException 擲回 。	XmlException 擲回 。
專案或屬性中的命名空間不存在於本機範圍中。	XmlException 擲回 。	XmlException 擲回 。	XmlException 擲回 。
資料包含前置詞命名空間不符。	XmlException 擲回 。	XmlException 擲回 。	XmlException 擲回 。
xml:space 屬性包含不正確值。	XmlException 擲回 。	XmlException 擲回 。	XmlException 擲回 。
發現無效的名稱。	XmlException 擲回 。	XmlException 擲回 。	XmlException 擲回 。
前置 xml 詞與 URI 不相符 http://www.w3.org/XML/1998/namespace 。	XmlException 擲回 。	XmlException 擲回 。	XmlException 擲回 。

另請參閱

• Create(String)