XmlValidatingReader-Konstruktor (Stream, XmlNodeType, XmlParserContext)

Initialisiert eine neue Instanz der XmlValidatingReader-Klasse mit den angegebenen Werten.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Sub New ( _
    xmlFragment As Stream, _
    fragType As XmlNodeType, _
    context As XmlParserContext _
)
'Usage
Dim xmlFragment As Stream
Dim fragType As XmlNodeType
Dim context As XmlParserContext

Dim instance As New XmlValidatingReader(xmlFragment, fragType, context)

public XmlValidatingReader (
    Stream xmlFragment,
    XmlNodeType fragType,
    XmlParserContext context
)

public:
XmlValidatingReader (
    Stream^ xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext^ context
)

public XmlValidatingReader (
    Stream xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext context
)

public function XmlValidatingReader (
    xmlFragment : Stream, 
    fragType : XmlNodeType, 
    context : XmlParserContext
)

Parameter

xmlFragment
Der Stream, der das zu analysierende XML-Fragment enthält.

fragType
Der XmlNodeType des XML-Fragments. Damit wird der mögliche Inhalt des Fragments bestimmt (siehe Tabelle unten).

context
Der XmlParserContext, in dem das XML-Fragment analysiert werden soll. Dazu gehören die zu verwendende XmlNameTable, die Codierung, der Namespacebereich, der aktuelle xml:lang-Bereich und der aktuelle xml:space-Bereich.

Ausnahmen

Ausnahmetyp	Bedingung
XmlException	fragType ist keiner der in der folgenden Tabelle aufgeführten Knotentypen.

Hinweise

Hinweis

Die XmlValidatingReader-Klasse ist in Microsoft .NET Framework, Version 2.0 veraltet. Sie können eine Instanz eines validierenden XmlReader mithilfe der XmlReaderSettings-Klasse und der Create-Methode erstellen. Weitere Informationen finden Sie unter Validieren von XML-Daten mit "XmlReader".

Dieser Konstruktor analysiert die angegebene Zeichenfolge als XML-Fragment. Wenn das XML-Fragment ein Element oder Attribut ist, können die Regeln auf Stammebene für wohlgeformte XML-Dokumente umgangen werden.

Die folgende Tabelle enthält eine Liste gültiger Werte für fragType sowie Informationen darüber, wie der Reader die einzelnen unterschiedlichen Knotentypen auswertet.

XmlNodeType	Möglicher Inhalt des Fragments
Element	Jeder gültige Elementinhalt (z. B. eine beliebige Kombination aus Elementen, Kommentaren, Verarbeitungsanweisungen, CDATA-Abschnitten, Text und Entitätsverweisen).
Attribute	Der Wert eines Attributs (der in Anführungszeichen eingeschlossene Teil).
Document	Der Inhalt eines vollständigen XML-Dokuments. Dies erzwingt Regeln auf Dokumentebene.

Der Reader bestimmt die Codierung des Streams auf folgende Weise:

Prüft die XmlParserContext.Encoding-Eigenschaft, um die Codierung zu bestimmen.
Wenn die Encoding-Eigenschaft NULL (Nothing in Visual Basic) ist, sucht der Reader am Anfang des Streams nach einer Bytereihenfolgemarkierung.
Wenn die Encoding-Eigenschaft NULL (Nothing in Visual Basic) ist und keine Bytereihenfolgemarkierung vorhanden ist, geht der Reader davon aus, dass der Stream in UTF-8 codiert ist.

Wenn dieser Reader die Validierung mit einer DTD (Dokumenttypdefinition) vornimmt (d. h., ValidationType ist auf ValidationType.DTD oder ValidationType.Auto festgelegt), muss der im Konstruktor angegebene XmlParserContext alle erforderlichen DocumentType-Informationen bereitstellen.

Hinweis

Fragmente können nicht mithilfe einer DTD validiert werden. Per Definition erfordert die Validierung mit einer DTD, dass ein vollständiges Dokument geladen ist.

Wenn dieser Reader die Validierung mithilfe von XDR (XML-Data Reduced)-Schemas oder XSD (XML Schema Definition Language)-Schemas durchführt, geben Sie unter Verwendung der Schemas-Eigenschaft die XmlSchemaCollection an, die die Schemas enthält. Das Bereitstellen von DocumentType-Informationen durch den XmlParserContext ist also nicht erforderlich.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XmlValidatingReader-Klasse
XmlValidatingReader-Member
System.Xml-Namespace

Weitere Ressourcen

Lesen von XML mit dem "XmlReader"

Last updated on 2007-08-20

Freigeben über