XmlReaderSettings.ValidationFlags Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, 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

Contoh 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 adalah 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 turunan 'divisi' yang tidak valid. 'ID' yang diharapkan.

Keterangan

Penting

Bendera validasi ProcessInlineSchema dan ProcessSchemaLocation dari objek XmlReaderSettings tidak diatur secara default. Ketika parameter ini diatur, XmlResolver dari objek XmlReaderSettings digunakan untuk menentukan lokasi skema yang ditemukan dalam dokumen instance pada XmlReader. Jika objek XmlResolver adalah null, lokasi skema tidak diselesaikan meskipun bendera validasi ProcessInlineSchema 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.

Menonaktifkan flag ProcessIdentityConstraints (yang diaktifkan secara default) disarankan ketika memvalidasi dokumen XML besar yang tidak tepercaya dalam skenario ketersediaan tinggi dengan skema yang memiliki batasan identitas di sebagian besar dokumen tersebut.

Lihat juga

• XmlReader
• Create(String)