XmlTextReader-Konstruktor (Stream, XmlNodeType, XmlParserContext)

Initialisiert eine neue Instanz der XmlTextReader-Klasse mit dem angegebenen Stream, XmlNodeType und XmlParserContext.

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 XmlTextReader(xmlFragment, fragType, context)

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

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

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

public function XmlTextReader (
    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 auch der mögliche Inhalt des Fragments bestimmt. (Siehe Tabelle unten.)

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

Ausnahmen

Ausnahmetyp	Bedingung
XmlException	fragType ist kein Element-, Attribut- oder Dokument-XmlNodeType.
ArgumentNullException	xmlFragment ist NULL (Nothing in Visual Basic).

Hinweise

Hinweis

Die empfohlene Vorgehensweise für die Version Microsoft .NET Framework, Version 2.0 besteht darin, mithilfe der System.Xml.XmlReader.Create-Methode XmlReader-Instanzen zu erstellen. So können Sie die neuen Features dieser Version in vollem Umfang nutzen. Weitere Informationen finden Sie unter Erstellen von XML-Readern.

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.

In der folgenden Tabelle sind gültige Werte für fragType aufgeführt.

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ätenverweisen). Eine XML-Deklaration kann ebenfalls angegeben werden. Dadurch können Sie die Codierung des XML-Fragments angeben und müssen es nicht auf das XmlParserContext-Objekt festlegen.
Attribute	Der Wert eines Attributs (der in Anführungszeichen eingeschlossene Teil).
Document	Der Inhalt eines vollständigen XML-Dokuments. Dies erzwingt die Regeln der Dokumentebene.

Der Reader bestimmt die Codierung des Streams auf folgende Weise.

1. Prüft die XmlParserContext.Encoding-Eigenschaft, um die Codierung zu bestimmen.

2. Wenn die Encoding-Eigenschaft NULL (Nothing in Visual Basic) ist, sucht der Reader am Anfang des Streams nach einer Bytereihenfolgemarkierung.

3. 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.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlTextReader-Klasse
XmlTextReader-Member
System.Xml-Namespace

Weitere Ressourcen

Lesen von XML mit dem "XmlReader"