XmlReaderSettings.ValidationFlags Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlReaderSettings.cs

Mendapatkan atau menetapkan nilai yang menunjukkan pengaturan validasi skema. Pengaturan ini berlaku untuk XmlReader objek yang memvalidasi skema (ValidationType properti diatur ke ValidationType.Schema).

public:
 property System::Xml::Schema::XmlSchemaValidationFlags ValidationFlags { System::Xml::Schema::XmlSchemaValidationFlags get(); void set(System::Xml::Schema::XmlSchemaValidationFlags value); };

public System.Xml.Schema.XmlSchemaValidationFlags ValidationFlags { get; set; }

member this.ValidationFlags : System.Xml.Schema.XmlSchemaValidationFlags with get, set

Public Property ValidationFlags As XmlSchemaValidationFlags

Nilai Properti

XmlSchemaValidationFlags

Kombinasi bitwise dari nilai enumerasi yang menentukan opsi validasi. ProcessIdentityConstraints dan AllowXmlAttributes diaktifkan secara default. ProcessInlineSchema, ProcessSchemaLocation, dan ReportValidationWarnings dinonaktifkan secara default.

Contoh

Contoh berikut memvalidasi file XML terhadap Skema XML sebaris dengan mengaktifkan ProcessInlineSchema pengaturan. Pembaca XML dikonfigurasi untuk menampilkan peringatan validasi, sehingga Anda juga melihat peringatan yang diharapkan pada elemen akar.

using System;
using System.Xml;
using System.Xml.Schema;
using System.IO;

public class ValidXSD {

  public static void Main() {

    // Set the validation settings.
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.ValidationType = ValidationType.Schema;
    settings.ValidationFlags |= XmlSchemaValidationFlags.ProcessInlineSchema;
    settings.ValidationFlags |= XmlSchemaValidationFlags.ReportValidationWarnings;
    settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

    // Create the XmlReader object.
    XmlReader reader = XmlReader.Create("inlineSchema.xml", settings);

    // Parse the file.
    while (reader.Read());
  }

  // Display any warnings or errors.
  private static void ValidationCallBack (object sender, ValidationEventArgs args) {
     if (args.Severity==XmlSeverityType.Warning)
       Console.WriteLine("\tWarning: Matching schema not found.  No validation occurred." + args.Message);
     else
        Console.WriteLine("\tValidation error: " + args.Message);
  }
}

Imports System.Xml
Imports System.Xml.Schema
Imports System.IO

public class ValidXSD 

  public shared sub Main() 

    ' Set the validation settings.
    Dim settings as XmlReaderSettings = new XmlReaderSettings()
    settings.ValidationType = ValidationType.Schema
    settings.ValidationFlags = settings.ValidationFlags Or XmlSchemaValidationFlags.ProcessInlineSchema
    settings.ValidationFlags = settings.ValidationFlags Or XmlSchemaValidationFlags.ReportValidationWarnings
      AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

    ' Create the XmlReader object.
    Dim reader as XmlReader = XmlReader.Create("inlineSchema.xml", settings)

    ' Parse the file. 
    while (reader.Read())
    end while
  end sub

  ' Display any warnings or errors.
  private shared sub ValidationCallBack (sender as object, args as ValidationEventArgs)
     if (args.Severity=XmlSeverityType.Warning)
       Console.WriteLine("   Warning: Matching schema not found.  No validation occurred." + args.Message)
     else
        Console.WriteLine("   Validation error: " + args.Message)
     end if
  end sub 

end class

Contohnya menggunakan file inlineSchema.xml sebagai input.

<root>
<!--Start of schema-->
<xs:schema xmlns:xs='http://www.w3.org/2001/XMLSchema'
            xmlns='xsdHeadCount'
            targetNamespace='xsdHeadCount'>
    <xs:element name='HeadCount'>
        <xs:complexType>
            <xs:sequence>
                <xs:element name='ID' type='xs:unsignedShort' maxOccurs='unbounded' />
            </xs:sequence>
            <xs:attribute name='division' type='xs:string' use='optional' default='QA'/>
        </xs:complexType>
    </xs:element>
</xs:schema>
<!--End of schema-->
<hc:HeadCount xmlns:hc='xsdHeadCount'>
    <ID>12365</ID>
    <ID>43295</ID>
    <division>Accounting</division>
</hc:HeadCount>
</root>

Outputnya sebagai berikut:

Peringatan: Skema yang cocok tidak ditemukan. Tidak ada validasi yang terjadi. Tidak dapat menemukan informasi skema untuk elemen 'root'.

Kesalahan validasi: Elemen 'xsdHeadCount:HeadCount' memiliki elemen anak 'divisi' yang tidak valid. 'ID' yang diharapkan.

Keterangan

Penting

ProcessInlineSchema Bendera validasi dan ProcessSchemaLocation objek XmlReaderSettings tidak diatur secara default. Ketika bendera ini diatur, XmlResolver objek XmlReaderSettings digunakan untuk menyelesaikan lokasi skema yang ditemui dalam dokumen instans di XmlReader. XmlResolver Jika objek adalah null, lokasi skema tidak diselesaikan meskipun ProcessInlineSchema bendera validasi dan ProcessSchemaLocation diatur.

Skema yang ditambahkan selama validasi menambahkan jenis baru dan dapat mengubah hasil validasi dokumen yang sedang divalidasi. Akibatnya, skema eksternal hanya boleh diselesaikan dari sumber tepercaya.

ProcessIdentityConstraints Menonaktifkan bendera (diaktifkan secara default) disarankan saat memvalidasi, dokumen XML besar yang tidak tepercaya dalam skenario ketersediaan tinggi terhadap skema dengan batasan identitas di sebagian besar dokumen.

Lihat juga

• XmlReader
• Create(String)