XmlTextReader Construtores

Definição

Inicializa uma nova instância do XmlTextReader.

Sobrecargas

Name Description
XmlTextReader()

Inicializa uma nova instância do XmlTextReader.

XmlTextReader(String, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da XmlTextReader classe com a cadeia especificada, XmlNodeType, e XmlParserContext.

XmlTextReader(String, TextReader, XmlNameTable)

Inicializa uma nova instância da XmlTextReader classe com a URL especificada, TextReader e XmlNameTable.

XmlTextReader(String, Stream, XmlNameTable)

Inicializa uma nova instância da XmlTextReader classe com o URL especificado, stream e XmlNameTable.

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado, XmlNodeType, e XmlParserContext.

XmlTextReader(String, TextReader)

Inicializa uma nova instância da XmlTextReader classe com o URL especificado e TextReader.

XmlTextReader(String, Stream)

Inicializa uma nova instância da XmlTextReader classe com o URL e stream especificados.

XmlTextReader(String, XmlNameTable)

Inicializa uma nova instância da XmlTextReader classe com o ficheiro especificado e XmlNameTable.

XmlTextReader(Stream, XmlNameTable)

Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado e XmlNameTable.

XmlTextReader(XmlNameTable)

Inicializa uma nova instância da XmlTextReader classe com o especificado XmlNameTable.

XmlTextReader(String)

Inicializa uma nova instância da XmlTextReader classe com o ficheiro especificado.

XmlTextReader(TextReader)

Inicializa uma nova instância da XmlTextReader classe com o especificado TextReader.

XmlTextReader(Stream)

Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado.

XmlTextReader(TextReader, XmlNameTable)

Inicializa uma nova instância da XmlTextReader classe com os especificados TextReader e XmlNameTable.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

XmlTextReader()

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância do XmlTextReader.

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

Ver também

Aplica-se a

XmlTextReader(String, XmlNodeType, XmlParserContext)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com a cadeia especificada, XmlNodeType, e 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)

Parâmetros

xmlFragment
String

A cadeia que contém o fragmento XML para analisar.

fragType
XmlNodeType

O XmlNodeType do fragmento XML. Isto também determina o que a corda do fragmento pode conter. (Ver tabela abaixo.)

context
XmlParserContext

O XmlParserContext em que o xmlFragment é para ser analisado. Isto inclui o XmlNameTable to use, a codificação, o âmbito do namespace, o atual xml:lange o xml:space scope.

Exceções

fragType não é um Element, Attribute, ou DocumentXmlNodeType.

xmlFragment é null.

Exemplos

O exemplo seguinte analisa um fragmento XML. Usa o XmlParserContext and its XmlNamespaceManager para gerir a resolução do namespace.

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

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Este construtor analisa a cadeia dada como um fragmento de XML. Se o fragmento XML for um elemento ou atributo, pode contornar as regras de nível raiz para documentos XML bem formados. Este construtor pode tratar cadeias retornadas de ReadInnerXml.

A tabela seguinte lista valores válidos para fragType e como o leitor analisa cada um dos diferentes tipos de nós.

XmlNodeType Fragmento pode conter
Elemento Qualquer conteúdo válido de elementos (por exemplo, qualquer combinação de elementos, comentários, instruções de processamento, secções CDATA, texto e referências de entidades).

Também pode ser fornecida uma declaração XML. Isto permite especificar a codificação do fragmento XML, em vez de ter de a definir no XmlParserContext objeto.
Attribute O valor de um atributo (a parte dentro das aspas).
Documento O conteúdo de um documento XML inteiro. Isto aplica regras ao nível do documento.

Ver também

Aplica-se a

XmlTextReader(String, TextReader, XmlNameTable)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com a URL especificada, TextReader e 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)

Parâmetros

url
String

O URL a usar para resolver recursos externos. O BaseURI é definido para este valor. Se url estiver null, BaseURI será definido como String.Empty.

input
TextReader

O TextReader que contém os dados XML para ler.

nt
XmlNameTable

O XmlNameTable para usar.

Exceções

O nt valor é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Assume-se que o TextReader já está definido para a codificação correta. Isto é usado por clientes que já leram algumas coisas do stream num cenário MIME de múltiplas partes.

Ver também

Aplica-se a

XmlTextReader(String, Stream, XmlNameTable)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o URL especificado, stream e 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)

Parâmetros

url
String

O URL a usar para resolver recursos externos. O BaseURI é definido para este valor. Se url estiver null, BaseURI será definido como String.Empty.

input
Stream

O fluxo que contém os dados XML para ler.

nt
XmlNameTable

O XmlNameTable para usar.

Exceções

O input valor de ou nt é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Ver também

Aplica-se a

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado, XmlNodeType, e 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)

Parâmetros

xmlFragment
Stream

O fluxo contendo o fragmento XML para analisar.

fragType
XmlNodeType

O XmlNodeType do fragmento XML. Isto também determina o que o fragmento pode conter. (Ver tabela abaixo.)

context
XmlParserContext

O XmlParserContext em que o xmlFragment é para ser analisado. Isto inclui o XmlNameTable to use, a codificação, o âmbito do namespace, o atual xml:lange o xml:space scope.

Exceções

fragType não é um Elemento, Atributo ou Documento XmlNodeType.

xmlFragment é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Este construtor analisa a cadeia dada como um fragmento de XML. Se o fragmento XML for um elemento ou atributo, pode contornar as regras de nível raiz para documentos XML bem formados.

A tabela seguinte lista valores válidos para fragType.

XmlNodeType Fragmento pode conter
Element Qualquer conteúdo válido de elementos (por exemplo, qualquer combinação de elementos, comentários, instruções de processamento, secções CDATA, texto e referências de entidades).

Também pode ser fornecida uma declaração XML. Isto permite especificar a codificação do fragmento XML, em vez de ter de a definir no XmlParserContext objeto.
Attribute O valor de um atributo (a parte dentro das aspas).
Document O conteúdo de um documento XML inteiro. Isto aplica regras ao nível do documento.

O leitor utiliza o seguinte para determinar a codificação do fluxo.

  1. Verifica a XmlParserContext.Encoding propriedade para determinar a codificação.

  2. Se a Encoding propriedade for null, o leitor verifica se há uma marca de ordem de bytes no início do fluxo.

  3. Se a Encoding propriedade for null, e não for encontrada marca de ordem de bytes, o leitor assume que o fluxo está codificado em UTF-8.

Ver também

Aplica-se a

XmlTextReader(String, TextReader)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o URL especificado e 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)

Parâmetros

url
String

O URL a usar para resolver recursos externos. O BaseURI é definido para este valor.

input
TextReader

O TextReader que contém os dados XML para ler.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Assume-se que o TextReader já está definido para a codificação correta. Isto é usado por clientes que já leram algumas coisas do stream num cenário MIME de múltiplas partes.

Ver também

Aplica-se a

XmlTextReader(String, Stream)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o URL e stream especificados.

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)

Parâmetros

url
String

O URL a usar para resolver recursos externos. O BaseURI é definido para este valor.

input
Stream

O fluxo que contém os dados XML para ler.

Exceções

input é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Ver também

Aplica-se a

XmlTextReader(String, XmlNameTable)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o ficheiro especificado e 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)

Parâmetros

url
String

O URL do ficheiro que contém os dados XML para ler.

nt
XmlNameTable

O XmlNameTable para usar.

Exceções

O nt valor é null.

O ficheiro especificado não pode ser encontrado.

Parte do nome do ficheiro ou diretório não pode ser encontrada.

url é uma corda vazia.

O nome remoto do ficheiro não pode ser resolvido.

-ou-

Ocorreu um erro durante o processamento do pedido.

url não é um URI válido.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Ver também

Aplica-se a

XmlTextReader(Stream, XmlNameTable)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado e 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)

Parâmetros

input
Stream

O fluxo que contém os dados XML para ler.

nt
XmlNameTable

O XmlNameTable para usar.

Exceções

O input valor de ou nt é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

A XmlTextReader decodifica o fluxo usando System.Text.Encoding.

Se especificar uma tabela de nomes, este construtor usa os nomes já definidos nessa tabela.

Ver também

Aplica-se a

XmlTextReader(XmlNameTable)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o especificado 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)

Parâmetros

nt
XmlNameTable

O XmlNameTable para usar.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Ver também

Aplica-se a

XmlTextReader(String)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o ficheiro especificado.

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

Parâmetros

url
String

O URL do ficheiro que contém os dados XML. O BaseURI é definido para este valor.

Exceções

O ficheiro especificado não pode ser encontrado.

Parte do nome do ficheiro ou diretório não pode ser encontrada.

url é uma corda vazia.

O nome remoto do ficheiro não pode ser resolvido.

-ou-

Ocorreu um erro durante o processamento do pedido.

url não é um URI válido.

Exemplos

O exemplo seguinte lê um ficheiro XML e mostra cada um dos nós.

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

O exemplo usa o ficheiro , items.xmlcomo entrada.


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

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Se o ficheiro estiver localizado num recurso que requer credenciais de acesso, use a XmlResolver propriedade para especificar as credenciais necessárias.

Note

Na versão 1.1 do .NET Framework, código parcialmente confiável não pode definir a propriedade XmlResolver. A solução alternativa é criar um XmlUrlResolver com as credenciais necessárias, passar o URI ao XmlUrlResolver.GetEntity método e depois construir o XmlTextReader usando o objeto resultante Stream . A solução alternativa é descrita no seguinte código C#.

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

Ver também

Aplica-se a

XmlTextReader(TextReader)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o especificado 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)

Parâmetros

input
TextReader

O TextReader que contém os dados XML para ler.

Exemplos

O exemplo seguinte carrega uma string XML no XmlTextReader objeto usando a StringReader classe.

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

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Assume-se que o TextReader já está definido para a codificação correta. Isto é usado por clientes que já leram algumas coisas do stream num cenário MIME de múltiplas partes.

Ver também

Aplica-se a

XmlTextReader(Stream)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com o fluxo especificado.

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)

Parâmetros

input
Stream

O fluxo que contém os dados XML para ler.

Exceções

input é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

A XmlTextReader decodifica o fluxo usando System.Text.Encoding.

Ver também

Aplica-se a

XmlTextReader(TextReader, XmlNameTable)

Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Inicializa uma nova instância da XmlTextReader classe com os especificados TextReader e 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)

Parâmetros

input
TextReader

O TextReader que contém os dados XML para ler.

nt
XmlNameTable

O XmlNameTable para usar.

Exceções

O nt valor é null.

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

Assume-se que o TextReader já está definido para a codificação correta. Isto é usado por clientes que já leram algumas coisas do stream num cenário MIME de múltiplas partes.

Ver também

Aplica-se a