XmlValidatingReader 類別實作了 XmlReader 類別,提供對多種類型的 XML 驗證支援:DTD、XML-Data Reduced(XDR)架構以及 XSD。其中 DTD 與 XSD 都是 W3C 官方推薦的標準,而 XDR 則是 Microsoft 早期用於處理 XML 架構的格式。
你可以用 XmlValidatingReader 驗證整份 XML 文件或 XML 片段。這個類別工作在 XML 閱讀器之上——通常是 XmlTextReader 類別的實例。XmlTextReader 負責讀取文件節點,而 XmlValidatingReader 則依據所需的驗證類型去驗證每一個 XML 區塊。
XmlValidatingReader 只實作了 XML 閱讀器必要功能中很小的一個子集,它總是工作在既有的 XML 閱讀器之上並加以監視。若查看它的建構子,會發現它明顯依賴一個既有的文字閱讀器,因此無法直接從檔案或 URL 序列化。其建構子形式如下:
public XmlValidatingReader(XmlReader); public XmlValidatingReader(Stream, XmlNodeType, XmlParserContext); public XmlValidatingReader(string, XmlNodeType, XmlParserContext);
帶驗證的閱讀器能分析任何透過字串或串流提供的 XML 片段,也能分析任何閱讀器提供的 XML 文件。它相對其他閱讀器類別而言,重大改變的方法並不多,除了 Read 之外,還有 Skip 與 ReadTypedValue 兩個方法:Skip 會跳過目前節點的所有子節點(同時仍會驗證被跳過的內容);ReadTypedValue 則回傳對應指定 XSD 型別的 CLR 型別,若找不到對應型別,就把節點值作為字串回傳。
顧名思義,帶驗證的閱讀器是一個基於節點的閱讀器,它驗證目前節點的結構是否符合目前的結構描述(schema)。驗證是「增量式」的——它並沒有一個方法回傳表示整份文件是否有效的布林值,而是通常透過 Read 方法逐步讀取輸入的 XML,在每一步檢查目前節點的結構是否與指定的 schema 相符;若不符,便拋出例外。以下是一個主控台應用程式範例,它從命令列接收檔名,最後輸出驗證結果:
using System;
using System.Xml;
using System.Xml.Schema;
class MyXmlValidApp
{
public MyXmlValidApp(String fileName)
{
try { Validate(fileName); }
catch (Exception e)
{
Console.WriteLine("Error:\t{0}", e.Message);
Console.WriteLine("Exception raised: {0}", e.GetType().ToString());
}
}
private void Validate(String fileName)
{
XmlTextReader xtr = new XmlTextReader(fileName);
XmlValidatingReader vreader = new XmlValidatingReader(xtr);
vreader.ValidationType = ValidationType.Auto;
vreader.ValidationEventHandler += new
ValidationEventHandler(this.ValidationEventHandle);
vreader.Read();
vreader.MoveToContent();
while (vreader.Read()) { }
xtr.Close();
vreader.Close();
}
public void ValidationEventHandle(Object sender, ValidationEventArgs args)
{
Console.Write("Validation error: " + args.Message + "\r\n");
}
public static void Main(String[] args)
{
MyXmlValidApp o = new MyXmlValidApp(args[0]);
return;
}
}