XmlValidatingReader Konstruktory

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Inicjuje nowe wystąpienie klasy XmlValidatingReader.

Przeciążenia

Nazwa	Opis
XmlValidatingReader(XmlReader)	Inicjuje XmlValidatingReader nowe wystąpienie klasy, które weryfikuje zawartość zwróconą z danego XmlReaderelementu .
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)	Inicjuje nowe wystąpienie XmlValidatingReader klasy z określonymi wartościami.
XmlValidatingReader(String, XmlNodeType, XmlParserContext)	Inicjuje nowe wystąpienie XmlValidatingReader klasy z określonymi wartościami.

XmlValidatingReader(XmlReader)

Źródło:

XmlValidatingReader.cs

Inicjuje XmlValidatingReader nowe wystąpienie klasy, które weryfikuje zawartość zwróconą z danego XmlReaderelementu .

public:
 XmlValidatingReader(System::Xml::XmlReader ^ reader);

public XmlValidatingReader(System.Xml.XmlReader reader);

new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReader

Public Sub New (reader As XmlReader)

Parametry

reader

XmlReader

Element XmlReader do odczytu podczas sprawdzania poprawności. Bieżąca implementacja obsługuje tylko XmlTextReader.

Wyjątki

ArgumentException

Określony czytnik nie jest elementem XmlTextReader.

Uwagi

Uwaga / Notatka

Klasa XmlValidatingReader jest przestarzała w programie .NET Framework 2.0. Wystąpienie weryfikacji XmlReader można utworzyć przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Wszystkie węzły zwrócone z danej XmlReader wartości są również zwracane z tego czytnika sprawdzania poprawności, więc nie ma utraty informacji w procesie. Ten czytelnik może dodać nowe węzły, które nie są zwracane z czytnika bazowego (na przykład atrybuty domyślne i elementy podrzędne odwołania do jednostki). Wszystkie właściwości ustawione dla danego XmlTextReader elementu mają również zastosowanie do tego czytnika sprawdzania poprawności. Jeśli na przykład podany czytnik miał ustawioną wartość WhitespaceHandling.None, ta walidacja czytnika również ignoruje biały znak.

Gdy do weryfikacji są potrzebne definicje typów dokumentów zewnętrznych (DTD) lub schematy, XmlResolver właściwość ustawia XmlResolver obiekt do użycia do rozpoznawania zasobów zewnętrznych.

Zobacz też

• XmlTextReader
• XmlReader

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Źródło:

XmlValidatingReader.cs

Inicjuje nowe wystąpienie XmlValidatingReader klasy z określonymi wartościami.

public:
 XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader

Public Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)

Parametry

xmlFragment

Stream

Strumień zawierający fragment XML do przeanalizowana.

fragType

XmlNodeType

Fragment XmlNodeType XML. Określa to, co może zawierać fragment (patrz poniższa tabela).

context

XmlParserContext

Element XmlParserContext , w którym fragment XML ma być analizowany. Obejmuje XmlNameTable to użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:langi xml:space zakres.

Wyjątki

XmlException

fragType nie jest jednym z typów węzłów wymienionych w poniższej tabeli.

Uwagi

Uwaga / Notatka

Klasa XmlValidatingReader jest przestarzała w programie .NET Framework 2.0. Wystąpienie weryfikacji XmlReader można utworzyć przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ten konstruktor analizuje dany ciąg jako fragment kodu XML. Jeśli fragment XML jest elementem lub atrybutem, można pominąć reguły poziomu głównego dla dobrze sformułowanych dokumentów XML.

W poniższej tabeli wymieniono prawidłowe wartości i fragType sposób analizowania poszczególnych typów węzłów przez czytelnika.

XmlNodeType	Fragment może zawierać
Składnik	Dowolna prawidłowa zawartość elementu (na przykład dowolna kombinacja elementów, komentarzy, instrukcji przetwarzania, danych cdata, tekstu i odwołań do jednostek).
Atrybut	Wartość atrybutu (część wewnątrz cudzysłowów).
Dokument	Zawartość całego dokumentu XML; Wymusza to reguły na poziomie dokumentu.

Czytelnik używa następujących kroków, aby określić kodowanie strumienia:

1. Sprawdza właściwość w XmlParserContext.Encoding celu określenia kodowania.

2. Encoding Jeśli właściwość to null, czytelnik sprawdza znacznik kolejności bajtów na początku strumienia.

3. Encoding Jeśli właściwość ma nullwartość , a nie znaleziono żadnego znacznika kolejności bajtów, czytelnik zakłada, że strumień jest zakodowany w formacie UTF-8.

Jeśli ten czytelnik będzie weryfikował przy użyciu definicji typu dokumentu (DTD) (tj. ValidationType jest ustawiony na ValidationType.DTD lub ValidationType.Auto), XmlParserContext określony w konstruktorze musi podać wszystkie niezbędne informacje DocumentType.

Uwaga / Notatka

Nie można zweryfikować fragmentu przy użyciu dtD. Zgodnie z definicją jednostka DTD wymaga załadowania całego dokumentu do weryfikacji.

Jeśli ten czytelnik będzie weryfikował przy użyciu schematów XML-Data Reduced (XDR) lub XML Schema Definition Language (XSD), użyj Schemas właściwości , aby określić XmlSchemaCollection , który zawiera schematy (czyli XmlParserContext nie musi dostarczać informacji DocumentType).

Zobacz też

• XmlReader

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Źródło:

XmlValidatingReader.cs

Inicjuje nowe wystąpienie XmlValidatingReader klasy z określonymi wartościami.

public:
 XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader

Public Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)

Parametry

xmlFragment

String

Ciąg zawierający fragment XML do przeanalizowana.

fragType

XmlNodeType

Fragment XmlNodeType XML. Określa to również, co może zawierać ciąg fragmentu (zobacz tabelę poniżej).

context

XmlParserContext

Element XmlParserContext , w którym fragment XML ma być analizowany. Obejmuje NameTable to użycie, kodowanie, zakres przestrzeni nazw, bieżący zakres xml:lang i xml:space.

Wyjątki

XmlException

fragType nie jest jednym z typów węzłów wymienionych w poniższej tabeli.

Uwagi

Uwaga / Notatka

Klasa XmlValidatingReader jest przestarzała w programie .NET Framework 2.0. Wystąpienie weryfikacji XmlReader można utworzyć przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ten konstruktor analizuje dany ciąg jako fragment kodu XML. Jeśli fragment XML jest elementem lub atrybutem, można pominąć reguły poziomu głównego dla dobrze sformułowanych dokumentów XML. Ten konstruktor może obsługiwać ciągi zwracane z ReadInnerXml.

W poniższej tabeli wymieniono prawidłowe wartości i fragType sposób analizowania poszczególnych typów węzłów przez czytelnika.

XmlNodeType	Fragment może zawierać
Składnik	Dowolna prawidłowa zawartość elementu (na przykład dowolna kombinacja elementów, komentarzy, instrukcji przetwarzania, danych cdata, tekstu i odwołań do jednostek).
Atrybut	Wartość atrybutu (część wewnątrz cudzysłowów).
Dokument	Zawartość całego dokumentu XML; Wymusza to reguły na poziomie dokumentu.

Jeśli ten czytelnik będzie weryfikował przy użyciu definicji typu dokumentu (DTD) (tj. ValidationType jest ustawiona na ValidationType.DTD lub ValidationType.Auto), XmlParserContext określony w konstruktorze musi podać wszystkie niezbędne informacje DocumentType.

Uwaga / Notatka

Nie można zweryfikować fragmentu przy użyciu dtD. Zgodnie z definicją DTD wymaga załadowania całego dokumentu do weryfikacji.

Jeśli ten czytelnik będzie weryfikował przy użyciu schematów XML-Data Reduced (XDR) lub XML Schema Definition Language (XSD), użyj Schemas właściwości , aby określić XmlSchemaCollection , który zawiera schematy ( XmlParserContext nie musi dostarczać informacji DocumentType).

Zobacz też

• XmlReader