XmlSchemaSet Třída

Definice

Obor názvů:

System.Xml.Schema

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlSchemaSet.cs

Obsahuje mezipaměť schémat jazyka XSD (XML Schema Definition Language).

public ref class XmlSchemaSet

public class XmlSchemaSet

type XmlSchemaSet = class

Public Class XmlSchemaSet

Dědičnost

Object

XmlSchemaSet

Příklady

Následující příklad ověří soubor XML pomocí schémat uložených v souboru XmlSchemaSet. Obor názvů v souboru XML, urn:bookstore-schema, určuje, které schéma XmlSchemaSet se má použít k ověření. Výstup z příkladu ukazuje, že soubor XML má dvě porušení schématu:

• První <book> prvek obsahuje <author> prvek, ale ne <title> nebo <price> prvek.

• Element <author> v posledním <book> elementu postrádá <first-name> a <last-name> element a místo toho obsahuje neplatný <name> element.

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

public class Sample
{
  public static void Main() {

    // Create the XmlSchemaSet class.
    XmlSchemaSet sc = new XmlSchemaSet();

    // Add the schema to the collection.
    sc.Add("urn:bookstore-schema", "books.xsd");

    // Set the validation settings.
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.ValidationType = ValidationType.Schema;
    settings.Schemas = sc;
    settings.ValidationEventHandler += ValidationCallBack;

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

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

  // Display any validation errors.
  private static void ValidationCallBack(object sender, ValidationEventArgs e) {
    Console.WriteLine($"Validation Error:\n   {e.Message}\n");
  }
}
// The example displays output like the following:
//   Validation Error:
//        The element 'book' in namespace 'urn:bookstore-schema' has invalid child element 'author'
//        in namespace 'urn:bookstore-schema'. List of possible elements expected: 'title' in
//        namespace 'urn:bookstore-schema'.
//
//    Validation Error:
//       The element 'author' in namespace 'urn:bookstore-schema' has invalid child element 'name'
//       in namespace 'urn:bookstore-schema'. List of possible elements expected: 'first-name' in
//       namespace 'urn:bookstore-schema'.

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

Public Module Sample 
  Public Sub Main() 

    ' Create the XmlSchemaSet class.
    Dim sc as XmlSchemaSet = new XmlSchemaSet()

    ' Add the schema to the collection.
    sc.Add("urn:bookstore-schema", "books.xsd")

    ' Set the validation settings.
    Dim settings as XmlReaderSettings = new XmlReaderSettings()
    settings.ValidationType = ValidationType.Schema
    settings.Schemas = sc
    AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack
 
    ' Create the XmlReader object.
    Dim reader as XmlReader = XmlReader.Create("booksSchemaFail.xml", settings)

    ' Parse the file. 
    While reader.Read()
    End While
    
  End Sub

  ' Display any validation errors.
  Private Sub ValidationCallBack(sender as object, e as ValidationEventArgs) 
    Console.WriteLine($"Validation Error:{vbCrLf}   {e.Message}")
    Console.WriteLine()
  End Sub
End Module
' The example displays output like the following:
'   Validation Error: 
'        The element 'book' in namespace 'urn:bookstore-schema' has invalid child element 'author' 
'        in namespace 'urn:bookstore-schema'. List of possible elements expected: 'title' in 
'        namespace 'urn:bookstore-schema'.
'
'    Validation Error: 
'       The element 'author' in namespace 'urn:bookstore-schema' has invalid child element 'name' 
'       in namespace 'urn:bookstore-schema'. List of possible elements expected: 'first-name' in 
'       namespace 'urn:bookstore-schema'.

Input

Ukázka používá následující dva vstupní soubory.

booksSchemaFail.xml:

<?xml version='1.0'?>
<bookstore xmlns="urn:bookstore-schema">
  <book>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
  </book>
  <book genre="novel">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

books.xsd:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="urn:bookstore-schema"
    elementFormDefault="qualified"
    targetNamespace="urn:bookstore-schema">

 <xsd:element name="bookstore" type="bookstoreType"/>

 <xsd:complexType name="bookstoreType">
  <xsd:sequence maxOccurs="unbounded">
   <xsd:element name="book"  type="bookType"/>
  </xsd:sequence>
 </xsd:complexType>

 <xsd:complexType name="bookType">
  <xsd:sequence>
   <xsd:element name="title" type="xsd:string"/>
   <xsd:element name="author" type="authorName"/>
   <xsd:element name="price"  type="xsd:decimal"/>
  </xsd:sequence>
  <xsd:attribute name="genre" type="xsd:string"/>
 </xsd:complexType>

 <xsd:complexType name="authorName">
  <xsd:sequence>
   <xsd:element name="first-name"  type="xsd:string"/>
   <xsd:element name="last-name" type="xsd:string"/>
  </xsd:sequence>
 </xsd:complexType>

</xsd:schema>

Poznámky

Important

• Nepoužívejte schémata z neznámých nebo nedůvěryhodných zdrojů nebo umístění. Tím dojde k ohrožení zabezpečení vašeho kódu.
• Schémata XML (včetně vložených schémat) jsou ze své podstaty zranitelná vůči útokům na odepření služeb; nepřijímají je v nedůvěryhodných scénářích.
• Chybové zprávy a výjimky týkající se ověřování schématu mohou odhalit citlivé informace o modelu obsahu nebo cestách URI k souboru se schématem. Dávejte pozor, abyste tyto informace nezpřístupnil nedůvěryhodným volajícím.
• Další aspekty zabezpečení jsou popsané v části Důležité informace o zabezpečení.

XmlSchemaSet je mezipaměť nebo knihovna, ve které můžete ukládat schémata XSD (XML Schema Definition Language). XmlSchemaSet zlepšuje výkon díky ukládání schémat do mezipaměti v paměti místo přístupu k nim ze souboru nebo adresy URL. Každé schéma je rozpoznáno pomocí URI oboru názvů a umístění, které bylo zadáno při přidání schématu do sady. Pomocí vlastnosti XmlReaderSettings.Schemas přiřadíte objekt XmlSchemaSet, který má XML čtenář používat k ověření dat.

Bezpečnostní aspekty

• Nepoužívejte schémata z neznámých nebo nedůvěryhodných zdrojů. Tím dojde k ohrožení zabezpečení vašeho kódu. Externí obory názvů nebo umístění odkazované v zahrnutí, importu a předefinování prvků schématu jsou vyřešeny s ohledem na základní identifikátor URI schématu, který je obsahuje nebo importuje. Například pokud je základní URI schématu, které zahrnuje nebo importuje, prázdné nebo null, jsou externí umístění vyřešena s ohledem na aktuální adresář. Třída XmlUrlResolver se používá k řešení externích schémat ve výchozím režimu. Chcete-li zakázat rozlišení zahrnutí, importu a předefinování prvků schématu, nastavte vlastnost XmlSchemaSet.XmlResolver na hodnotu null.

• Třída XmlSchemaSet používá System.Text.RegularExpressions.Regex třídu k analýze a porovnávání regulárních výrazů ve schématu XML. Ověření vlastností vzorů pomocí regulárních výrazů ve schématu XML může zahrnovat zvýšené využití procesoru a mělo by se jim vyhnout ve scénářích s vysokou dostupností.

• Výjimky vyvolané použitím třídy XmlSchemaSet, jako je třída XmlSchemaException, mohou obsahovat citlivé informace, které by neměly být odhaleny v nedůvěryhodných scénářích. SourceUri Například vlastnost XmlSchemaException vrací cestu URI k souboru schématu, který způsobil výjimku. Vlastnost SourceUri by neměla být vystavena v nedůvěryhodných scénářích. Výjimky by se měly správně zpracovat, aby tyto citlivé informace nebyly zpřístupněny v nedůvěryhodných scénářích.

Konstruktory

Name	Description
XmlSchemaSet()	Inicializuje novou instanci XmlSchemaSet třídy.
XmlSchemaSet(XmlNameTable)	Inicializuje novou instanci XmlSchemaSet třídy se zadaným XmlNameTable.

Vlastnosti

Name	Description
CompilationSettings	Získá nebo nastaví XmlSchemaCompilationSettings pro XmlSchemaSet.
Count	Získá počet logických schémat XML Schema definition language (XSD) schémat v objektu XmlSchemaSet.
GlobalAttributes	Získá všechny globální atributy ve všech schématu XML Schema Definition Language (XSD) schématu v objektu XmlSchemaSet.
GlobalElements	Získá všechny globální prvky ve všech schématu XML Schema definition language (XSD) schématu XmlSchemaSetv rozhraní .
GlobalTypes	Získá všechny globální jednoduché a komplexní typy ve všech schématu XML Schema definition language (XSD) schématu XmlSchemaSetv .
IsCompiled	Získá hodnotu, která určuje, zda schémata XML Schema definition language (XSD) schémata v XmlSchemaSet byly zkompilovány.
NameTable	Získá výchozí XmlNameTable používané XmlSchemaSet při načítání nových schémat XML Schema Definition Language (XSD).
XmlResolver	XmlResolver Nastaví použité k překladu oborů názvů nebo umístění odkazovaných v zahrnutí a importu prvků schématu.

Metody

Name	Description
Add(String, String)	Přidá schéma jazyka XSD (XML Schema Definition Language) na adrese URL zadané do objektu XmlSchemaSet.
Add(String, XmlReader)	Přidá schéma XSD (XML Schema Definition Language) obsažené v objektu XmlReaderXmlSchemaSet.
Add(XmlSchema)	Přidá danou XmlSchema hodnotu XmlSchemaSetdo .
Add(XmlSchemaSet)	Přidá všechna schémata jazyka XSD (XML Schema Definition Language) v dané XmlSchemaSet sadě XmlSchemaSet.
Compile()	Zkompiluje schémata jazyka XSD (XML Schema Definition Language) přidaná do jednoho logického XmlSchemaSet schématu.
Contains(String)	Určuje, zda schéma jazyka XSD (XML Schema Definition Language) se zadaným cílovým oborem názvů URI je v XmlSchemaSetsouboru .
Contains(XmlSchema)	Určuje, zda je zadaný objekt XSD (XML Schema Definition Language) XmlSchema v objektu XmlSchemaSet.
CopyTo(XmlSchema[], Int32)	Zkopíruje všechny XmlSchema objekty z XmlSchemaSet daného pole počínaje daným indexem.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Remove(XmlSchema)	Odebere zadané schéma XSD (XML Schema Definition Language) ze schématu XmlSchemaSet.
RemoveRecursive(XmlSchema)	Odebere zadané schéma XSD (XML Schema Definition Language) a všechna schémata, která importuje z objektu XmlSchemaSet.
Reprocess(XmlSchema)	Znovu zpracuje schéma jazyka XSD (Xml Schema Definition Language), které již v objektu XmlSchemaSet.
Schemas()	Vrátí kolekci všech schémat XSD (XML Schema Definition Language) v objektu XmlSchemaSet.
Schemas(String)	Vrátí kolekci všech schémat XSD (XML Schema Definition Language) v XmlSchemaSet oboru názvů, které patří do daného oboru názvů.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

Name	Description
ValidationEventHandler	Určuje obslužnou rutinu události pro příjem informací o chybách ověřování schématu XML (XSD) schématu.