XmlValidatingReader.ValidationType 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定數值,表示要執行的驗證類型。
public:
property System::Xml::ValidationType ValidationType { System::Xml::ValidationType get(); void set(System::Xml::ValidationType value); };
public System.Xml.ValidationType ValidationType { get; set; }
member this.ValidationType : System.Xml.ValidationType with get, set
Public Property ValidationType As ValidationType
屬性值
其中一個 ValidationType 值。 若未設定這個屬性,則預設為 ValidationType.Auto。
例外狀況
在呼叫 Read 之後設定這個屬性。
範例
下列範例會驗證兩個檔案。
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Schema;
public ref class Sample
{
private:
XmlTextReader^ txtreader;
XmlValidatingReader^ reader;
Boolean m_success;
public:
Sample()
{
txtreader = nullptr;
reader = nullptr;
m_success = true;
String^ doc1 = "notValid.xml";
String^ doc2 = "cdDTD.xml";
String^ doc3 = "book1.xml";
//Parse the files and validate when requested.
Validate( doc1, ValidationType::XDR ); //Validation should fail.
Validate( doc2, ValidationType::DTD ); //Validation should fail.
Validate( doc3, ValidationType::None ); //No validation performed.
}
private:
void Validate( String^ filename, ValidationType vt )
{
try
{
//Implement the readers. Set the ValidationType.
txtreader = gcnew XmlTextReader( filename );
reader = gcnew XmlValidatingReader( txtreader );
reader->ValidationType = vt;
//If the reader is set to validate, set the event handler.
if ( vt == ValidationType::None )
Console::WriteLine( "\nParsing XML file {0}", filename );
else
{
Console::WriteLine( "\nValidating XML file {0}", filename );
m_success = true;
//Set the validation event handler.
reader->ValidationEventHandler += gcnew ValidationEventHandler( this, &Sample::ValidationCallBack );
}
// Read XML data
while ( reader->Read() )
{}
if ( vt == ValidationType::None )
Console::WriteLine( "Finished parsing file." );
else
Console::WriteLine( "Validation finished. Validation {0}", m_success ? (String^)"successful" : "failed" );
}
finally
{
//Close the reader.
if ( reader != nullptr )
reader->Close();
}
}
//Display the validation errors.
void ValidationCallBack( Object^ /*sender*/, ValidationEventArgs^ args )
{
m_success = false;
Console::Write( "\r\n\tValidation error: {0}", args->Message );
}
};
int main()
{
gcnew Sample;
}
using System;
using System.IO;
using System.Xml;
using System.Xml.Schema;
public class Sample
{
private const String doc1 = "notValid.xml";
private const String doc2 = "cdDTD.xml";
private const String doc3 = "book1.xml";
private XmlTextReader txtreader = null;
private XmlValidatingReader reader = null;
private Boolean m_success = true;
public Sample ()
{
//Parse the files and validate when requested.
Validate(doc1, ValidationType.XDR); //Validation should fail.
Validate(doc2, ValidationType.DTD); //Validation should fail.
Validate(doc3, ValidationType.None); //No validation performed.
}
public static void Main ()
{
Sample validation = new Sample();
}
private void Validate(String filename, ValidationType vt)
{
try
{
//Implement the readers. Set the ValidationType.
txtreader = new XmlTextReader(filename);
reader = new XmlValidatingReader(txtreader);
reader.ValidationType = vt;
//If the reader is set to validate, set the event handler.
if (vt==ValidationType.None)
{
Console.WriteLine("\nParsing XML file " + filename.ToString());
}
else
{
Console.WriteLine("\nValidating XML file " + filename.ToString());
m_success = true;
//Set the validation event handler.
reader.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);
}
// Read XML data
while (reader.Read()){}
if (vt==ValidationType.None)
Console.WriteLine("Finished parsing file.");
else
Console.WriteLine ("Validation finished. Validation {0}", (m_success==true ? "successful" : "failed"));
}
finally
{
//Close the reader.
if (reader != null)
reader.Close();
}
}
//Display the validation errors.
private void ValidationCallBack (object sender, ValidationEventArgs args)
{
m_success = false;
Console.Write("\r\n\tValidation error: " + args.Message);
}
}
Imports System.IO
Imports System.Xml
Imports System.Xml.Schema
Public Class Sample
Private doc1 As String = "notValid.xml"
Private doc2 As String = "cdDTD.xml"
Private doc3 As String = "book1.xml"
Private txtreader As XmlTextReader = Nothing
Private reader As XmlValidatingReader = Nothing
Private m_success As Boolean = True
Public Sub New()
'Parse the files and validate when requested.
Validate(doc1, ValidationType.XDR) 'Validation should fail.
Validate(doc2, ValidationType.DTD) 'Validation should fail.
Validate(doc3, ValidationType.None) 'No validation performed.
End Sub
Public Shared Sub Main()
Dim validation As New Sample()
End Sub
Private Sub Validate(filename As String, vt As ValidationType)
Try
'Implement the readers. Set the ValidationType.
txtreader = New XmlTextReader(filename)
reader = New XmlValidatingReader(txtreader)
reader.ValidationType = vt
'If the reader is set to validate, set the event handler.
If vt = ValidationType.None Then
Console.WriteLine(ControlChars.Cr & "Parsing XML file " & filename.ToString())
Else
Console.WriteLine(ControlChars.Cr & "Validating XML file " & filename.ToString())
m_success = True
'Set the validation event handler.
AddHandler reader.ValidationEventHandler, AddressOf ValidationCallBack
End If
' Read XML data
While reader.Read()
End While
If vt = ValidationType.None Then
Console.WriteLine("Finished parsing file.")
Else
Console.WriteLine("Validation finished. Validation {0}", IIf(m_success, "successful", "failed"))
End If
Finally
'Close the reader.
If Not (reader Is Nothing) Then
reader.Close()
End If
End Try
End Sub
'Display the validation errors.
Private Sub ValidationCallBack(sender As Object, args As ValidationEventArgs)
m_success = False
Console.Write(ControlChars.CrLf & ControlChars.Tab & "Validation error: " & args.Message)
End Sub
End Class
此範例使用下列四個輸入檔:
notValid.xml
(「x-schema:」 前置詞會識別 reader.) (XDR) 架構XML-Data縮減
<?xml version='1.0'?>
<bookstore xmlns="x-schema:schema1.xdr">
<book genre="novel" style="hardcover">
<title>The Handmaid's Tale</title>
<author>
<first-name>Margaret</first-name>
<last-name>Atwood</last-name>
</author>
<price>19.95</price>
</book>
<book genre="novel" style="other">
<title>The Poisonwood Bible</title>
<author>
<first-name>Barbara</first-name>
<last-name>Kingsolver</last-name>
</author>
<price>11.99</price>
</book>
</bookstore>
schema1.xdr
<?xml version="1.0"?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data"
xmlns:dt="urn:schemas-microsoft-com:datatypes">
<ElementType name="first-name" content="textOnly"/>
<ElementType name="last-name" content="textOnly"/>
<ElementType name="name" content="textOnly"/>
<ElementType name="price" content="textOnly" dt:type="fixed.14.4"/>
<ElementType name="author" content="eltOnly" order="one">
<group order="seq">
<element type="name"/>
</group>
<group order="seq">
<element type="first-name"/>
<element type="last-name"/>
</group>
</ElementType>
<ElementType name="title" content="textOnly"/>
<AttributeType name="genre" dt:type="string"/>
<AttributeType name="style" dt:type="enumeration"
dt:values="paperback hardcover"/>
<ElementType name="book" content="eltOnly">
<attribute type="genre" required="yes"/>
<attribute type="style" required="yes"/>
<element type="title"/>
<element type="author"/>
<element type="price"/>
</ElementType>
<ElementType name="bookstore" content="eltOnly">
<element type="book"/>
</ElementType>
</Schema>
cdDTD.xml
<!--XML file using a DTD-->
<!DOCTYPE bookstore [
<!ELEMENT bookstore (cd)*>
<!ELEMENT cd (title,artist,price)>
<!ATTLIST cd genre CDATA #REQUIRED>
<!ELEMENT title (#PCDATA)>
<!ELEMENT artist (#PCDATA)>
<!ELEMENT price (#PCDATA)>]>
<bookstore>
<cd genre="alternative" ISBN="2-3631-4">
<title>Americana</title>
<artist>Offspring</artist>
<price>16.95</price>
</cd>
</bookstore>
book1.xml
<?xml version='1.0' ?>
<!DOCTYPE book [<!ENTITY h 'hardcover'>]>
<book>
<title>Pride And Prejudice</title>
<misc>&h;</misc>
</book>
備註
注意
類別 XmlValidatingReader 在 .NET Framework 2.0 中已過時。 您可以使用 類別和 Create 方法建立驗證 XmlReader 實例 XmlReaderSettings 。 如需詳細資訊,請參閱 XmlReader 參考頁面的<備註>一節。
在第一次呼叫 Read 之前,必須先設定這個屬性。 將此屬性設定為 ValidationType.None 會建立非驗證讀取器。
如果需要外部檔案類型定義 (DTD) 或架構進行驗證, XmlResolver 則會使用 。