Freigeben über


XmlTextReader Konstruktoren

Definition

Initialisiert eine neue Instanz der XmlTextReader.

Überlädt

Name Beschreibung
XmlTextReader()

Initialisiert eine neue Instanz der XmlTextReader.

XmlTextReader(String, XmlNodeType, XmlParserContext)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen Zeichenfolge, XmlNodeTypeund XmlParserContext.

XmlTextReader(String, TextReader, XmlNameTable)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL TextReader und XmlNameTable.

XmlTextReader(String, Stream, XmlNameTable)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL, dem Datenstrom und XmlNameTabledem angegebenen .

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen Datenstrom und XmlNodeTypeXmlParserContext.

XmlTextReader(String, TextReader)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL und TextReader.

XmlTextReader(String, Stream)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL und dem angegebenen Datenstrom.

XmlTextReader(String, XmlNameTable)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen Datei und XmlNameTable.

XmlTextReader(Stream, XmlNameTable)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen Datenstrom und XmlNameTable.

XmlTextReader(XmlNameTable)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen XmlNameTable.

XmlTextReader(String)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen Datei.

XmlTextReader(TextReader)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen TextReader.

XmlTextReader(Stream)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen Datenstrom.

XmlTextReader(TextReader, XmlNameTable)

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen TextReader und XmlNameTable.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

XmlTextReader()

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader.

protected:
 XmlTextReader();
protected XmlTextReader();
Protected Sub New ()

Weitere Informationen

Gilt für:

XmlTextReader(String, XmlNodeType, XmlParserContext)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen Zeichenfolge, XmlNodeTypeund XmlParserContext.

public:
 XmlTextReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);
public XmlTextReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext? context);
public XmlTextReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);
new System.Xml.XmlTextReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlTextReader
Public Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)

Parameter

xmlFragment
String

Die Zeichenfolge, die das zu analysierende XML-Fragment enthält.

fragType
XmlNodeType

Das XmlNodeType XML-Fragment. Dadurch wird auch bestimmt, welche Fragmentzeichenfolge enthalten kann. (Siehe Tabelle unten.)

context
XmlParserContext

xmlFragment Der XmlParserContext zu analysierende Inhalt. Dies schließt die XmlNameTable Verwendung, Codierung, Namespacebereich, den aktuellen xml:langund den xml:space Bereich ein.

Ausnahmen

fragTypeist kein Element, oder AttributeDocumentXmlNodeType.

xmlFragment ist null.

Beispiele

Im folgenden Beispiel wird ein XML-Fragment analysiert. Es verwendet die XmlParserContext Namespaceauflösung und deren XmlNamespaceManager , um die Namespaceauflösung zu behandeln.

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

public class Sample
{
  public static void Main()
  {

    //Create the XML fragment to be parsed.
    string xmlFrag ="<book> " +
                    "<title>Pride And Prejudice</title>" +
                    "<bk:genre>novel</bk:genre>" +
                    "</book>";

    //Create the XmlNamespaceManager.
    NameTable nt = new NameTable();
    XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
    nsmgr.AddNamespace("bk", "urn:sample");

    //Create the XmlParserContext.
    XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

    //Create the reader.
    XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context);

    //Parse the XML.  If they exist, display the prefix and
    //namespace URI of each element.
    while (reader.Read()){
      if (reader.IsStartElement()){
        if (reader.Prefix==String.Empty)
                {
                    Console.WriteLine("<{0}>", reader.LocalName);
                }
                else
                {
            Console.Write("<{0}:{1}>", reader.Prefix, reader.LocalName);
            Console.WriteLine(" The namespace URI is " + reader.NamespaceURI);
        }
      }
    }

    //Close the reader.
    reader.Close();
  }
} // End class
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main()

    'Create the XML fragment to be parsed.
    Dim xmlFrag as string ="<book> " & _
                           "<title>Pride And Prejudice</title>" & _
                           "<bk:genre>novel</bk:genre>" & _
                           "</book>" 

    'Create the XmlNamespaceManager.
    Dim nt as NameTable = new NameTable()
    Dim nsmgr as XmlNamespaceManager = new XmlNamespaceManager(nt)
    nsmgr.AddNamespace("bk", "urn:sample")

    'Create the XmlParserContext.
    Dim context as XmlParserContext = new XmlParserContext(nothing, nsmgr, nothing, XmlSpace.None)

    'Create the reader. 
    Dim reader as XmlTextReader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context)
  
    'Parse the XML.  If they exist, display the prefix and  
    'namespace URI of each element.
    while (reader.Read())
      if (reader.IsStartElement())
        if (reader.Prefix=String.Empty)
           Console.WriteLine("<{0}>", reader.LocalName)
        else
            Console.Write("<{0}:{1}>", reader.Prefix, reader.LocalName)
            Console.WriteLine(" The namespace URI is " + reader.NamespaceURI)
        end if 
      end if
    end while
  
    'Close the reader.
    reader.Close()     
  
  end sub
end class

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Dieser Konstruktor analysiert die angegebene Zeichenfolge als XML-Fragment. Wenn das XML-Fragment ein Element oder Attribut ist, können Sie die Regeln auf Stammebene für wohlgeformte XML-Dokumente umgehen. Dieser Konstruktor kann Zeichenfolgen verarbeiten, die von ReadInnerXml.

In der folgenden Tabelle sind gültige Werte aufgeführt, für fragType die und wie der Leser jeden der verschiedenen Knotentypen analysiert.

Xmlnodetype Fragment kann enthalten sein
Element Beliebige gültige Elementinhalte (z. B. eine beliebige Kombination aus Elementen, Kommentaren, Verarbeitungsanweisungen, CDATA-Abschnitten, Text- und Entitätsverweisen).

Eine XML-Deklaration kann auch bereitgestellt werden. Auf diese Weise können Sie die Codierung für das XML-Fragment angeben, anstatt sie für das XmlParserContext Objekt festlegen zu müssen.
Merkmal Der Wert eines Attributs (der Teil innerhalb der Anführungszeichen).
Dokument Der Inhalt eines gesamten XML-Dokuments. Dadurch werden Regeln auf Dokumentebene erzwungen.

Weitere Informationen

Gilt für:

XmlTextReader(String, TextReader, XmlNameTable)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL TextReader und XmlNameTable.

public:
 XmlTextReader(System::String ^ url, System::IO::TextReader ^ input, System::Xml::XmlNameTable ^ nt);
public XmlTextReader(string url, System.IO.TextReader input, System.Xml.XmlNameTable nt);
new System.Xml.XmlTextReader : string * System.IO.TextReader * System.Xml.XmlNameTable -> System.Xml.XmlTextReader
Public Sub New (url As String, input As TextReader, nt As XmlNameTable)

Parameter

url
String

Die URL, die zum Auflösen externer Ressourcen verwendet werden soll. Der BaseURI Wert wird auf diesen Wert festgelegt. Ist url ,nullBaseURI, ist auf String.Empty.

input
TextReader

Die TextReader zu lesenden XML-Daten.

nt
XmlNameTable

Die XmlNameTable zu verwendende.

Ausnahmen

Der wert nt ist null.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Es wird davon ausgegangen, dass die TextReader Codierung bereits auf die richtige Codierung festgelegt ist. Dies wird von Clients verwendet, die bereits einige Elemente aus dem Datenstrom in einem mehrteiligen MIME-Szenario gelesen haben.

Weitere Informationen

Gilt für:

XmlTextReader(String, Stream, XmlNameTable)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL, dem Datenstrom und XmlNameTabledem angegebenen .

public:
 XmlTextReader(System::String ^ url, System::IO::Stream ^ input, System::Xml::XmlNameTable ^ nt);
public XmlTextReader(string url, System.IO.Stream input, System.Xml.XmlNameTable nt);
new System.Xml.XmlTextReader : string * System.IO.Stream * System.Xml.XmlNameTable -> System.Xml.XmlTextReader
Public Sub New (url As String, input As Stream, nt As XmlNameTable)

Parameter

url
String

Die URL, die zum Auflösen externer Ressourcen verwendet werden soll. Der BaseURI Wert wird auf diesen Wert festgelegt. Ist url ,nullBaseURI, ist auf String.Empty.

input
Stream

Der Datenstrom, der die zu lesenden XML-Daten enthält.

nt
XmlNameTable

Die XmlNameTable zu verwendende.

Ausnahmen

Der input Wert ist ntnull.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Weitere Informationen

Gilt für:

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen Datenstrom und XmlNodeTypeXmlParserContext.

public:
 XmlTextReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);
public XmlTextReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext? context);
public XmlTextReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);
new System.Xml.XmlTextReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlTextReader
Public Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)

Parameter

xmlFragment
Stream

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

fragType
XmlNodeType

Das XmlNodeType XML-Fragment. Dies bestimmt auch, was das Fragment enthalten kann. (Siehe Tabelle unten.)

context
XmlParserContext

xmlFragment Der XmlParserContext zu analysierende Inhalt. Dies schließt die XmlNameTable Verwendung, Codierung, Namespacebereich, den aktuellen xml:langund den xml:space Bereich ein.

Ausnahmen

fragType ist kein Element, Attribut oder Dokument XmlNodeType.

xmlFragment ist null.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

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

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

Xmlnodetype Fragment kann enthalten sein
Element Beliebige gültige Elementinhalte (z. B. eine beliebige Kombination aus Elementen, Kommentaren, Verarbeitungsanweisungen, CDATA-Abschnitten, Text- und Entitätsverweisen).

Eine XML-Deklaration kann auch bereitgestellt werden. Auf diese Weise können Sie die Codierung für das XML-Fragment angeben, anstatt sie für das XmlParserContext Objekt festlegen zu müssen.
Attribute Der Wert eines Attributs (der Teil innerhalb der Anführungszeichen).
Document Der Inhalt eines gesamten XML-Dokuments. Dadurch werden Regeln auf Dokumentebene erzwungen.

Der Leser verwendet Folgendes, um die Codierung des Datenstroms zu bestimmen.

  1. Überprüft die XmlParserContext.Encoding Eigenschaft, um die Codierung zu bestimmen.

  2. Wenn die Encoding Eigenschaft lautet null, sucht der Leser am Anfang des Datenstroms nach einer Bytereihenfolgemarke.

  3. Wenn die Encoding Eigenschaft ist nullund kein Bytereihenfolgezeichen gefunden wird, geht der Leser davon aus, dass der Datenstrom in UTF-8 codiert ist.

Weitere Informationen

Gilt für:

XmlTextReader(String, TextReader)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL und TextReader.

public:
 XmlTextReader(System::String ^ url, System::IO::TextReader ^ input);
public XmlTextReader(string url, System.IO.TextReader input);
new System.Xml.XmlTextReader : string * System.IO.TextReader -> System.Xml.XmlTextReader
Public Sub New (url As String, input As TextReader)

Parameter

url
String

Die URL, die zum Auflösen externer Ressourcen verwendet werden soll. Der BaseURI Wert wird auf diesen Wert festgelegt.

input
TextReader

Die TextReader zu lesenden XML-Daten.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Es wird davon ausgegangen, dass die TextReader Codierung bereits auf die richtige Codierung festgelegt ist. Dies wird von Clients verwendet, die bereits einige Elemente aus dem Datenstrom in einem mehrteiligen MIME-Szenario gelesen haben.

Weitere Informationen

Gilt für:

XmlTextReader(String, Stream)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen URL und dem angegebenen Datenstrom.

public:
 XmlTextReader(System::String ^ url, System::IO::Stream ^ input);
public XmlTextReader(string url, System.IO.Stream input);
new System.Xml.XmlTextReader : string * System.IO.Stream -> System.Xml.XmlTextReader
Public Sub New (url As String, input As Stream)

Parameter

url
String

Die URL, die zum Auflösen externer Ressourcen verwendet werden soll. Der BaseURI Wert wird auf diesen Wert festgelegt.

input
Stream

Der Datenstrom, der die zu lesenden XML-Daten enthält.

Ausnahmen

input ist null.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Weitere Informationen

Gilt für:

XmlTextReader(String, XmlNameTable)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen Datei und XmlNameTable.

public:
 XmlTextReader(System::String ^ url, System::Xml::XmlNameTable ^ nt);
public XmlTextReader(string url, System.Xml.XmlNameTable nt);
new System.Xml.XmlTextReader : string * System.Xml.XmlNameTable -> System.Xml.XmlTextReader
Public Sub New (url As String, nt As XmlNameTable)

Parameter

url
String

Die URL für die Datei, die die zu lesenden XML-Daten enthält.

nt
XmlNameTable

Die XmlNameTable zu verwendende.

Ausnahmen

Der wert nt ist null.

Die angegebene Datei wurde nicht gefunden.

Ein Teil des Dateinamens oder Verzeichnisses wurde nicht gefunden.

url ist eine leere Zeichenfolge.

Der Remotedateiname kann nicht aufgelöst werden.

- oder -

Fehler beim Verarbeiten der Anforderung.

url ist kein gültiger URI.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Weitere Informationen

Gilt für:

XmlTextReader(Stream, XmlNameTable)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen Datenstrom und XmlNameTable.

public:
 XmlTextReader(System::IO::Stream ^ input, System::Xml::XmlNameTable ^ nt);
public XmlTextReader(System.IO.Stream input, System.Xml.XmlNameTable nt);
new System.Xml.XmlTextReader : System.IO.Stream * System.Xml.XmlNameTable -> System.Xml.XmlTextReader
Public Sub New (input As Stream, nt As XmlNameTable)

Parameter

input
Stream

Der Datenstrom, der die zu lesenden XML-Daten enthält.

nt
XmlNameTable

Die XmlNameTable zu verwendende.

Ausnahmen

Der input Wert ist ntnull.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Der XmlTextReader Datenstrom wird durch die Decodierung des Datenstroms decodiert System.Text.Encoding.

Wenn Sie eine Namenstabelle angeben, verwendet dieser Konstruktor die bereits in dieser Tabelle definierten Namen.

Weitere Informationen

Gilt für:

XmlTextReader(XmlNameTable)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen XmlNameTable.

protected:
 XmlTextReader(System::Xml::XmlNameTable ^ nt);
protected XmlTextReader(System.Xml.XmlNameTable nt);
new System.Xml.XmlTextReader : System.Xml.XmlNameTable -> System.Xml.XmlTextReader
Protected Sub New (nt As XmlNameTable)

Parameter

nt
XmlNameTable

Die XmlNameTable zu verwendende.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Weitere Informationen

Gilt für:

XmlTextReader(String)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit der angegebenen Datei.

public:
 XmlTextReader(System::String ^ url);
public XmlTextReader(string url);
new System.Xml.XmlTextReader : string -> System.Xml.XmlTextReader
Public Sub New (url As String)

Parameter

url
String

Die URL für die Datei, die die XML-Daten enthält. Der BaseURI Wert wird auf diesen Wert festgelegt.

Ausnahmen

Die angegebene Datei wurde nicht gefunden.

Ein Teil des Dateinamens oder Verzeichnisses wurde nicht gefunden.

url ist eine leere Zeichenfolge.

Der Remotedateiname kann nicht aufgelöst werden.

- oder -

Fehler beim Verarbeiten der Anforderung.

url ist kein gültiger URI.

Beispiele

Im folgenden Beispiel wird eine XML-Datei gelesen und die einzelnen Knoten angezeigt.

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

public class Sample {

  private const String filename = "items.xml";

  public static void Main() {

     XmlTextReader reader = null;

     try {

        // Load the reader with the data file and ignore all white space nodes.
        reader = new XmlTextReader(filename);
        reader.WhitespaceHandling = WhitespaceHandling.None;

        // Parse the file and display each of the nodes.
        while (reader.Read()) {
           switch (reader.NodeType) {
             case XmlNodeType.Element:
               Console.Write("<{0}>", reader.Name);
               break;
             case XmlNodeType.Text:
               Console.Write(reader.Value);
               break;
             case XmlNodeType.CDATA:
               Console.Write("<![CDATA[{0}]]>", reader.Value);
               break;
             case XmlNodeType.ProcessingInstruction:
               Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
               break;
             case XmlNodeType.Comment:
               Console.Write("<!--{0}-->", reader.Value);
               break;
             case XmlNodeType.XmlDeclaration:
               Console.Write("<?xml version='1.0'?>");
               break;
             case XmlNodeType.Document:
               break;
             case XmlNodeType.DocumentType:
               Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
               break;
             case XmlNodeType.EntityReference:
               Console.Write(reader.Name);
               break;
             case XmlNodeType.EndElement:
               Console.Write("</{0}>", reader.Name);
               break;
           }
        }
     }

     finally {
        if (reader!=null)
          reader.Close();
     }
  }
} // End class
Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

'Reads an XML document
Public Class Sample
    Private Const filename As String = "items.xml"
    
    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing
        
        Try
            ' Load the reader with the data file and ignore all white space nodes.         
            reader = New XmlTextReader(filename)
            reader.WhitespaceHandling = WhitespaceHandling.None
            
            ' Parse the file and display each of the nodes.
            While reader.Read()
                Select Case reader.NodeType
                    Case XmlNodeType.Element
                        Console.Write("<{0}>", reader.Name)
                    Case XmlNodeType.Text
                        Console.Write(reader.Value)
                    Case XmlNodeType.CDATA
                        Console.Write("<![CDATA[{0}]]>", reader.Value)
                    Case XmlNodeType.ProcessingInstruction
                        Console.Write("<?{0} {1}?>", reader.Name, reader.Value)
                    Case XmlNodeType.Comment
                        Console.Write("<!--{0}-->", reader.Value)
                    Case XmlNodeType.XmlDeclaration
                        Console.Write("<?xml version='1.0'?>")
                    Case XmlNodeType.Document
                    Case XmlNodeType.DocumentType
                        Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value)
                    Case XmlNodeType.EntityReference
                        Console.Write(reader.Name)
                    Case XmlNodeType.EndElement
                        Console.Write("</{0}>", reader.Name)
                End Select
            End While
        
        Finally
            If Not (reader Is Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub
End Class

Im Beispiel wird die Datei als items.xmlEingabe verwendet.


<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
  <Item>Test with an entity: &number;</Item>
  <Item>test with a child element <more/> stuff</Item>
  <Item>test with a CDATA section <![CDATA[<456>]]> def</Item>
  <Item>Test with an char entity: A</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Wenn sich die Datei in einer Ressource befindet, die Zugriffsanmeldeinformationen erfordert, verwenden Sie die XmlResolver Eigenschaft, um die erforderlichen Anmeldeinformationen anzugeben.

Hinweis

In Version 1.1 von .NET Framework kann teilweise vertrauenswürdiger Code die XmlResolver Eigenschaft nicht festlegen. Die Problemumgehung besteht darin, eine XmlUrlResolver mit den erforderlichen Anmeldeinformationen zu erstellen, den URI an die XmlUrlResolver.GetEntity Methode zu übergeben und dann das XmlTextReader resultierende Stream Objekt zu erstellen. Die Problemumgehung wird im folgenden C#-Code beschrieben.

// Create a resolver with the necessary credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
NetworkCredential nc = new NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain);
resolver.Credentials = nc;
// Get a Stream object containing the XML file.
Uri myUri = new Uri ("http://myServer/data/books.xml");
Stream s=(Stream)resolver.GetEntity(myUri, null, typeof(Stream));
// Construct a reader using the Stream object.
XmlTextReader reader = new XmlTextReader(s);

Weitere Informationen

Gilt für:

XmlTextReader(TextReader)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen TextReader.

public:
 XmlTextReader(System::IO::TextReader ^ input);
public XmlTextReader(System.IO.TextReader input);
new System.Xml.XmlTextReader : System.IO.TextReader -> System.Xml.XmlTextReader
Public Sub New (input As TextReader)

Parameter

input
TextReader

Die TextReader zu lesenden XML-Daten.

Beispiele

Im folgenden Beispiel wird eine XML-Zeichenfolge mithilfe der StringReader Klasse in das XmlTextReader Objekt geladen.

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

public class Sample {

  public static void Main() {

    string xmlData =
    @"<book>
       <title>Oberon's Legacy</title>
       <price>5.95</price>
      </book>";

    // Create the reader.
    XmlTextReader reader = new XmlTextReader(new StringReader(xmlData));
    reader.WhitespaceHandling = WhitespaceHandling.None;

    // Display each element node.
    while (reader.Read()){
       switch (reader.NodeType){
         case XmlNodeType.Element:
           Console.Write("<{0}>", reader.Name);
           break;
         case XmlNodeType.Text:
           Console.Write(reader.Value);
           break;
         case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
      }
    }

    // Close the reader.
    reader.Close();
  }
} // End class
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main()

    Dim xmlData as string 
    xmlData = "<book>" & _
              "  <title>Oberon's Legacy</title>" & _
              "  <price>5.95</price>" & _
              "</book>"

    ' Create the reader.
    Dim reader as XmlTextReader = new XmlTextReader(new StringReader(xmlData))
    reader.WhitespaceHandling = WhitespaceHandling.None

    ' Display each element node.
    while reader.Read()
       select case reader.NodeType
         case XmlNodeType.Element
           Console.Write("<{0}>", reader.Name)
         case XmlNodeType.Text
           Console.Write(reader.Value)
         case XmlNodeType.EndElement
           Console.Write("</{0}>", reader.Name)
       end select       
    end while           

    ' Close the reader.
    reader.Close()       
  end sub
end class

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Es wird davon ausgegangen, dass die TextReader Codierung bereits auf die richtige Codierung festgelegt ist. Dies wird von Clients verwendet, die bereits einige Elemente aus dem Datenstrom in einem mehrteiligen MIME-Szenario gelesen haben.

Weitere Informationen

Gilt für:

XmlTextReader(Stream)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen Datenstrom.

public:
 XmlTextReader(System::IO::Stream ^ input);
public XmlTextReader(System.IO.Stream input);
new System.Xml.XmlTextReader : System.IO.Stream -> System.Xml.XmlTextReader
Public Sub New (input As Stream)

Parameter

input
Stream

Der Datenstrom, der die zu lesenden XML-Daten enthält.

Ausnahmen

input ist null.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Der XmlTextReader Datenstrom wird durch die Decodierung des Datenstroms decodiert System.Text.Encoding.

Weitere Informationen

Gilt für:

XmlTextReader(TextReader, XmlNameTable)

Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs

Initialisiert eine neue Instanz der XmlTextReader Klasse mit dem angegebenen TextReader und XmlNameTable.

public:
 XmlTextReader(System::IO::TextReader ^ input, System::Xml::XmlNameTable ^ nt);
public XmlTextReader(System.IO.TextReader input, System.Xml.XmlNameTable nt);
new System.Xml.XmlTextReader : System.IO.TextReader * System.Xml.XmlNameTable -> System.Xml.XmlTextReader
Public Sub New (input As TextReader, nt As XmlNameTable)

Parameter

input
TextReader

Die TextReader zu lesenden XML-Daten.

nt
XmlNameTable

Die XmlNameTable zu verwendende.

Ausnahmen

Der wert nt ist null.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Es wird davon ausgegangen, dass die TextReader Codierung bereits auf die richtige Codierung festgelegt ist. Dies wird von Clients verwendet, die bereits einige Elemente aus dem Datenstrom in einem mehrteiligen MIME-Szenario gelesen haben.

Weitere Informationen

Gilt für: