XmlTextReader Konstruktorok

Definíció

Inicializálja a XmlTextReader.

Túlterhelések

Name Description
XmlTextReader()

Inicializálja a XmlTextReader.

XmlTextReader(String, XmlNodeType, XmlParserContext)

Inicializálja az XmlTextReader osztály új példányát a megadott sztringgel, XmlNodeTypeés XmlParserContext.

XmlTextReader(String, TextReader, XmlNameTable)

Inicializálja az osztály új példányát XmlTextReader a megadott URL-címmel és TextReaderXmlNameTable.

XmlTextReader(String, Stream, XmlNameTable)

Inicializálja az osztály új példányát a XmlTextReader megadott URL-címmel, streameléssel és XmlNameTable.

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Inicializálja az osztály új példányát XmlTextReader a megadott adatfolyammal, XmlNodeTypeés XmlParserContext.

XmlTextReader(String, TextReader)

Inicializálja az osztály új példányát XmlTextReader a megadott URL-címmel és TextReader.

XmlTextReader(String, Stream)

Inicializálja az osztály új példányát XmlTextReader a megadott URL-címmel és streameléssel.

XmlTextReader(String, XmlNameTable)

Inicializálja az osztály új példányát XmlTextReader a megadott fájllal és XmlNameTable.

XmlTextReader(Stream, XmlNameTable)

Inicializálja az osztály új példányát XmlTextReader a megadott adatfolyammal és XmlNameTable.

XmlTextReader(XmlNameTable)

Inicializálja az osztály új példányát XmlTextReader a megadott XmlNameTable.

XmlTextReader(String)

Inicializálja az osztály új példányát XmlTextReader a megadott fájllal.

XmlTextReader(TextReader)

Inicializálja az osztály új példányát XmlTextReader a megadott TextReader.

XmlTextReader(Stream)

Inicializálja az osztály új példányát XmlTextReader a megadott adatfolyammal.

XmlTextReader(TextReader, XmlNameTable)

Inicializálja az osztály új példányát a XmlTextReader megadott TextReader és XmlNameTablea .

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

XmlTextReader()

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja a XmlTextReader.

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

Lásd még

A következőre érvényes:

XmlTextReader(String, XmlNodeType, XmlParserContext)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az XmlTextReader osztály új példányát a megadott sztringgel, XmlNodeTypeés 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)

Paraméterek

xmlFragment
String

Az elemezni kívánt XML-töredéket tartalmazó sztring.

fragType
XmlNodeType

Az XmlNodeType XML-töredék. Ez azt is meghatározza, hogy a töredék sztring mit tartalmazhat. (Lásd az alábbi táblázatot.)

context
XmlParserContext

Az XmlParserContext , amelyben az xmlFragment elemzést el kell adni. Ez magában foglalja a XmlNameTable használni kívánt, kódolási, névtér-hatókört, az aktuálisat xml:langés a hatókört xml:space .

Kivételek

fragType nem egy Element, Attributevagy DocumentXmlNodeType.

xmlFragment az null.

Példák

Az alábbi példa egy XML-töredék elemzése. Az és annak XmlParserContext használatával XmlNamespaceManager kezeli a névtérfeloldásokat.

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

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Ez a konstruktor xml-töredékként elemzi az adott sztringet. Ha az XML-töredék elem vagy attribútum, megkerülheti a jól formázott XML-dokumentumok gyökérszintű szabályait. Ez a konstruktor képes kezelni a visszaadott ReadInnerXmlsztringeket.

Az alábbi táblázat felsorolja az egyes csomóponttípusok érvényes értékeit fragType , és azt, hogy az olvasó hogyan elemzi az egyes csomóponttípusokat.

XmlNodeType A töredék tartalmazhat
Elem Bármilyen érvényes elemtartalom (például elemek, megjegyzések, feldolgozási utasítások, CDATA-szakaszok, szöveg és entitáshivatkozások bármilyen kombinációja).

XML-deklaráció is megadható. Ez lehetővé teszi az XML-töredék kódolásának megadását ahelyett, hogy az XmlParserContext objektumon kellene beállítania.
Attribute Egy attribútum értéke (az idézőjeleken belüli rész).
Dokumentum Egy teljes XML-dokumentum tartalma. Ez kikényszeríti a dokumentumszintű szabályokat.

Lásd még

A következőre érvényes:

XmlTextReader(String, TextReader, XmlNameTable)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott URL-címmel és TextReaderXmlNameTable.

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)

Paraméterek

url
String

A külső erőforrások feloldásához használandó URL-cím. Az BaseURI érték erre az értékre van állítva. Ha urlnull, BaseURIString.Emptyértékre van állítva.

input
TextReader

Az TextReader olvasni kívánt XML-adatokat tartalmazó.

nt
XmlNameTable

A XmlNameTable használni kívánt.

Kivételek

Az nt érték a következő null: .

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Feltételezzük, hogy a TextReader rendszer már a megfelelő kódolásra van beállítva. Ezt azok az ügyfelek használják, akik már olvastak néhány dolgot a streamből egy többrészes MIME-forgatókönyvben.

Lásd még

A következőre érvényes:

XmlTextReader(String, Stream, XmlNameTable)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát a XmlTextReader megadott URL-címmel, streameléssel és XmlNameTable.

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)

Paraméterek

url
String

A külső erőforrások feloldásához használandó URL-cím. Az BaseURI érték erre az értékre van állítva. Ha urlnull, BaseURIString.Emptyértékre van állítva.

input
Stream

Az olvasni kívánt XML-adatokat tartalmazó adatfolyam.

nt
XmlNameTable

A XmlNameTable használni kívánt.

Kivételek

Az input vagy nt az érték.null

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Lásd még

A következőre érvényes:

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott adatfolyammal, XmlNodeTypeés XmlParserContext.

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)

Paraméterek

xmlFragment
Stream

Az elemezni kívánt XML-töredéket tartalmazó adatfolyam.

fragType
XmlNodeType

Az XmlNodeType XML-töredék. Ez azt is meghatározza, hogy a töredék mit tartalmazhat. (Lásd az alábbi táblázatot.)

context
XmlParserContext

Az XmlParserContext , amelyben az xmlFragment elemzést el kell adni. Ez magában foglalja a XmlNameTable használni kívánt, kódolási, névtér-hatókört, az aktuálisat xml:langés a hatókört xml:space .

Kivételek

fragType nem elem, attribútum vagy dokumentum XmlNodeType.

xmlFragment az null.

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Ez a konstruktor xml-töredékként elemzi az adott sztringet. Ha az XML-töredék elem vagy attribútum, megkerülheti a jól formázott XML-dokumentumok gyökérszintű szabályait.

Az alábbi táblázat a következőhöz tartozó érvényes értékeket sorolja fel fragType:

XmlNodeType A töredék tartalmazhat
Element Bármilyen érvényes elemtartalom (például elemek, megjegyzések, feldolgozási utasítások, CDATA-szakaszok, szöveg és entitáshivatkozások bármilyen kombinációja).

XML-deklaráció is megadható. Ez lehetővé teszi az XML-töredék kódolásának megadását ahelyett, hogy az XmlParserContext objektumon kellene beállítania.
Attribute Egy attribútum értéke (az idézőjeleken belüli rész).
Document Egy teljes XML-dokumentum tartalma. Ez kikényszeríti a dokumentumszintű szabályokat.

Az olvasó az alábbiakat használja a stream kódolásának meghatározásához.

  1. Ellenőrzi a XmlParserContext.Encoding tulajdonságot a kódolás meghatározásához.

  2. Ha a Encoding tulajdonság az null, az olvasó egy bájtsorrend-jelet keres a stream elején.

  3. Ha a Encoding tulajdonság , nullés nem található bájtsorrendjel, az olvasó feltételezi, hogy a stream UTF-8-ban van kódolva.

Lásd még

A következőre érvényes:

XmlTextReader(String, TextReader)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott URL-címmel és 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)

Paraméterek

url
String

A külső erőforrások feloldásához használandó URL-cím. Az BaseURI érték erre az értékre van állítva.

input
TextReader

Az TextReader olvasni kívánt XML-adatokat tartalmazó.

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Feltételezzük, hogy a TextReader rendszer már a megfelelő kódolásra van beállítva. Ezt azok az ügyfelek használják, akik már olvastak néhány dolgot a streamből egy többrészes MIME-forgatókönyvben.

Lásd még

A következőre érvényes:

XmlTextReader(String, Stream)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott URL-címmel és streameléssel.

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)

Paraméterek

url
String

A külső erőforrások feloldásához használandó URL-cím. Az BaseURI érték erre az értékre van állítva.

input
Stream

Az olvasni kívánt XML-adatokat tartalmazó adatfolyam.

Kivételek

input az null.

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Lásd még

A következőre érvényes:

XmlTextReader(String, XmlNameTable)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott fájllal és 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)

Paraméterek

url
String

Az olvasni kívánt XML-adatokat tartalmazó fájl URL-címe.

nt
XmlNameTable

A XmlNameTable használni kívánt.

Kivételek

Az nt érték a következő null: .

A megadott fájl nem található.

A fájlnév vagy könyvtár egy része nem található.

url üres sztring.

A távoli fájlnév nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

url nem érvényes URI.

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Lásd még

A következőre érvényes:

XmlTextReader(Stream, XmlNameTable)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott adatfolyammal és 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)

Paraméterek

input
Stream

Az olvasni kívánt XML-adatokat tartalmazó adatfolyam.

nt
XmlNameTable

A XmlNameTable használni kívánt.

Kivételek

Az input vagy nt az érték.null

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

A XmlTextReader kódoló a streamet a következővel System.Text.Encodingdekódolja: .

Ha névtáblát ad meg, a konstruktor a táblában már definiált neveket használja.

Lásd még

A következőre érvényes:

XmlTextReader(XmlNameTable)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott 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)

Paraméterek

nt
XmlNameTable

A XmlNameTable használni kívánt.

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Lásd még

A következőre érvényes:

XmlTextReader(String)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott fájllal.

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

Paraméterek

url
String

Az XML-adatokat tartalmazó fájl URL-címe. Az BaseURI érték erre az értékre van állítva.

Kivételek

A megadott fájl nem található.

A fájlnév vagy könyvtár egy része nem található.

url üres sztring.

A távoli fájlnév nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

url nem érvényes URI.

Példák

Az alábbi példa egy XML-fájlt olvas be, és megjeleníti az egyes csomópontokat.

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

A példa a fájlt items.xmlhasználja bemenetként.


<?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>

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Ha a fájl olyan erőforráson található, amelyhez hozzáférési hitelesítő adatok szükségesek, a XmlResolver tulajdonság használatával adja meg a szükséges hitelesítő adatokat.

Note

A .NET-keretrendszer 1.1-es verziójában a részben megbízható kód nem tudja beállítani a XmlResolver tulajdonságot. A megkerülő megoldás a szükséges hitelesítő adatokkal rendelkező létrehozása XmlUrlResolver , az URI átadása a XmlUrlResolver.GetEntity metódusnak, majd az XmlTextReader eredményül Stream kapott objektum létrehozása. A megkerülő megoldást a következő C#-kód ismerteti.

// 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);

Lásd még

A következőre érvényes:

XmlTextReader(TextReader)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott 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)

Paraméterek

input
TextReader

Az TextReader olvasni kívánt XML-adatokat tartalmazó.

Példák

Az alábbi példa egy XML-sztringet tölt be az objektumba az XmlTextReaderStringReader osztály használatával.

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

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Feltételezzük, hogy a TextReader rendszer már a megfelelő kódolásra van beállítva. Ezt azok az ügyfelek használják, akik már olvastak néhány dolgot a streamből egy többrészes MIME-forgatókönyvben.

Lásd még

A következőre érvényes:

XmlTextReader(Stream)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát XmlTextReader a megadott adatfolyammal.

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)

Paraméterek

input
Stream

Az olvasni kívánt XML-adatokat tartalmazó adatfolyam.

Kivételek

input az null.

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

A XmlTextReader kódoló a streamet a következővel System.Text.Encodingdekódolja: .

Lásd még

A következőre érvényes:

XmlTextReader(TextReader, XmlNameTable)

Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs
Forrás:
XmlTextReader.cs

Inicializálja az osztály új példányát a XmlTextReader megadott TextReader és XmlNameTablea .

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)

Paraméterek

input
TextReader

Az TextReader olvasni kívánt XML-adatokat tartalmazó.

nt
XmlNameTable

A XmlNameTable használni kívánt.

Kivételek

Az nt érték a következő null: .

Megjegyzések

Note

Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.

Feltételezzük, hogy a TextReader rendszer már a megfelelő kódolásra van beállítva. Ezt azok az ügyfelek használják, akik már olvastak néhány dolgot a streamből egy többrészes MIME-forgatókönyvben.

Lásd még

A következőre érvényes: