XmlTextReader Construtores

Definição

Inicializa uma nova instância do XmlTextReader.Initializes a new instance of the XmlTextReader.

Sobrecargas

XmlTextReader()

Inicializa uma nova instância do XmlTextReader.Initializes a new instance of the XmlTextReader.

XmlTextReader(String, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com a cadeia de caracteres especificada, XmlNodeType e XmlParserContext.Initializes a new instance of the XmlTextReader class with the specified string, XmlNodeType, and XmlParserContext.

XmlTextReader(String, TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada, TextReader e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified URL, TextReader and XmlNameTable.

XmlTextReader(String, Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL, o fluxo e XmlNameTable especificados.Initializes a new instance of the XmlTextReader class with the specified URL, stream and XmlNameTable.

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado, XmlNodeType e XmlParserContext.Initializes a new instance of the XmlTextReader class with the specified stream, XmlNodeType, and XmlParserContext.

XmlTextReader(String, TextReader)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada e TextReader.Initializes a new instance of the XmlTextReader class with the specified URL and TextReader.

XmlTextReader(String, Stream)

Inicializa uma nova instância da classe XmlTextReader com a URL e o fluxo especificados.Initializes a new instance of the XmlTextReader class with the specified URL and stream.

XmlTextReader(String, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified file and XmlNameTable.

XmlTextReader(Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified stream and XmlNameTable.

XmlTextReader(XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o XmlNameTable especificado.Initializes a new instance of the XmlTextReader class with the specified XmlNameTable.

XmlTextReader(String)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado.Initializes a new instance of the XmlTextReader class with the specified file.

XmlTextReader(TextReader)

Inicializa uma nova instância da classe XmlTextReader com o TextReader especificado.Initializes a new instance of the XmlTextReader class with the specified TextReader.

XmlTextReader(Stream)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado.Initializes a new instance of the XmlTextReader class with the specified stream.

XmlTextReader(TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o TextReader e XmlNameTable especificados.Initializes a new instance of the XmlTextReader class with the specified TextReader and XmlNameTable.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

XmlTextReader()

Inicializa uma nova instância do XmlTextReader.Initializes a new instance of the XmlTextReader.

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

Veja também

XmlTextReader(String, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com a cadeia de caracteres especificada, XmlNodeType e XmlParserContext.Initializes a new instance of the XmlTextReader class with the specified string, XmlNodeType, and 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);
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 de caracteres que contém o fragmento XML a ser analisado.The string containing the XML fragment to parse.

fragType
XmlNodeType

O XmlNodeType do fragmento XML.The XmlNodeType of the XML fragment. Ele também determina o que a cadeia de caracteres de fragmento pode conter.This also determines what the fragment string can contain. (Consulte a tabela abaixo.)(See table below.)

context
XmlParserContext

O XmlParserContext no qual o xmlFragment deve ser analisados.The XmlParserContext in which the xmlFragment is to be parsed. Isso inclui o XmlNameTable a ser usado, codificação, o escopo de namespace, o xml:lang atual e o escopo xml:space.This includes the XmlNameTable to use, encoding, namespace scope, the current xml:lang, and the xml:space scope.

Exceções

fragType não é um Element, Attribute ou DocumentXmlNodeType.fragType is not an Element, Attribute, or DocumentXmlNodeType.

xmlFragment é null.xmlFragment is null.

Exemplos

O exemplo a seguir analisa um fragmento XML.The following example parses an XML fragment. Ele usa o XmlParserContext e seu XmlNamespaceManager para tratar a resolução do namespace.It uses the XmlParserContext and its XmlNamespaceManager to handle namespace resolution.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int 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 = gcnew NameTable;
   XmlNamespaceManager^ nsmgr = gcnew XmlNamespaceManager( nt );
   nsmgr->AddNamespace( "bk", "urn:sample" );
   
   // Create the XmlParserContext.
   XmlParserContext^ context = gcnew XmlParserContext( nullptr,nsmgr,nullptr,XmlSpace::None );
   
   // Create the reader. 
   XmlTextReader^ reader = gcnew 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 {0}", reader->NamespaceURI );
         }
      }
   }

   
   // Close the reader.
   reader->Close();
}

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

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Esse construtor analisa a cadeia de caracteres fornecida como um fragmento de XML.This constructor parses the given string as a fragment of XML. Se o fragmento XML for um elemento ou atributo, você poderá ignorar as regras de nível raiz para documentos XML bem formados.If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents. Esse construtor pode manipular cadeias de caracteres retornadas de ReadInnerXml.This constructor can handle strings returned from ReadInnerXml.

A tabela a seguir lista os valores válidos para fragType e como o leitor analisa cada um dos diferentes tipos de nó.The following table lists valid values for fragType and how the reader parses each of the different node types.

XmlNodeTypeXmlNodeType O fragmento pode conterFragment May Contain
ElementoElement Qualquer conteúdo de elemento válido (por exemplo, qualquer combinação de elementos, comentários, instruções de processamento, seções CDATA, texto e referências de entidade).Any valid element content (for example, any combination of elements, comments, processing instructions, CDATA sections, text, and entity references).

Uma declaração XML também pode ser fornecida.An XML declaration can also be supplied. Isso permite que você especifique a codificação para o fragmento XML, em vez de ter que defini-lo no objeto XmlParserContext.This allows you to specify the encoding for the XML fragment, rather than having to set it on the XmlParserContext object.
AtributoAttribute O valor de um atributo (a parte dentro das aspas).The value of an attribute (the part inside the quotes).
DocumentoDocument O conteúdo de um documento inteiro XML.The contents of an entire XML document. Isso impõe regras de nível de documento.This enforces document level rules.

Veja também

XmlTextReader(String, TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada, TextReader e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified URL, TextReader and 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

A URL a ser usada para resolver recursos externos.The URL to use for resolving external resources. O BaseURI é definido para esse valor.The BaseURI is set to this value. Se url é null, BaseURI é definido como String.Empty.If url is null, BaseURI is set to String.Empty.

input
TextReader

O TextReader que contém os dados XML a serem lidos.The TextReader containing the XML data to read.

nt
XmlNameTable

O XmlNameTable a ser usado.The XmlNameTable to use.

Exceções

O valor nt é null.The nt value is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Supõe-se que TextReader já esteja definido como a codificação correta.It is assumed that the TextReader is already set to the correct encoding. Isso é usado por clientes que já lêem algumas coisas do fluxo em um cenário MIME de várias partes.This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

Veja também

XmlTextReader(String, Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com a URL, o fluxo e XmlNameTable especificados.Initializes a new instance of the XmlTextReader class with the specified URL, stream and 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

A URL a ser usada para resolver recursos externos.The URL to use for resolving external resources. O BaseURI é definido para esse valor.The BaseURI is set to this value. Se url é null, BaseURI é definido como String.Empty.If url is null, BaseURI is set to String.Empty.

input
Stream

O fluxo que contém os dados XML a serem lidos.The stream containing the XML data to read.

nt
XmlNameTable

O XmlNameTable a ser usado.The XmlNameTable to use.

Exceções

O valor input ou nt é null.The input or nt value is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Veja também

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado, XmlNodeType e XmlParserContext.Initializes a new instance of the XmlTextReader class with the specified stream, XmlNodeType, and 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);
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 que contém o fragmento XML a ser analisado.The stream containing the XML fragment to parse.

fragType
XmlNodeType

O XmlNodeType do fragmento XML.The XmlNodeType of the XML fragment. Ele também determina o que o fragmento pode conter.This also determines what the fragment can contain. (Consulte a tabela abaixo.)(See table below.)

context
XmlParserContext

O XmlParserContext no qual o xmlFragment deve ser analisados.The XmlParserContext in which the xmlFragment is to be parsed. Isso inclui o XmlNameTable a ser usado, codificação, o escopo de namespace, o xml:lang atual e o escopo xml:space.This includes the XmlNameTable to use, encoding, namespace scope, the current xml:lang, and the xml:space scope.

Exceções

fragType não é um Elemento, Atributo ou Documento XmlNodeType.fragType is not an Element, Attribute, or Document XmlNodeType.

xmlFragment é null.xmlFragment is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Esse construtor analisa a cadeia de caracteres fornecida como um fragmento de XML.This constructor parses the given string as a fragment of XML. Se o fragmento XML for um elemento ou atributo, você poderá ignorar as regras de nível raiz para documentos XML bem formados.If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents.

A tabela a seguir lista os valores válidos para fragType.The following table lists valid values for fragType.

XmlNodeTypeXmlNodeType O fragmento pode conterFragment May Contain
Element Qualquer conteúdo de elemento válido (por exemplo, qualquer combinação de elementos, comentários, instruções de processamento, seções CDATA, texto e referências de entidade).Any valid element content (for example, any combination of elements, comments, processing instructions, CDATA sections, text, and entity references).

Uma declaração XML também pode ser fornecida.An XML declaration can also be supplied. Isso permite que você especifique a codificação para o fragmento XML, em vez de ter que defini-lo no objeto XmlParserContext.This allows you to specify the encoding for the XML fragment, rather than having to set it on the XmlParserContext object.
Attribute O valor de um atributo (a parte dentro das aspas).The value of an attribute (the part inside the quotes).
Document O conteúdo de um documento inteiro XML.The contents of an entire XML document. Isso impõe regras de nível de documento.This enforces document level rules.

O leitor usa o seguinte para determinar a codificação do fluxo.The reader uses the following to determine the encoding of the stream.

  1. Verifica a propriedade XmlParserContext.Encoding para determinar a codificação.Checks the XmlParserContext.Encoding property to determine the encoding.

  2. Se a propriedade Encoding for null, o leitor verificará uma marca de ordem de byte no início do fluxo.If the Encoding property is null, the reader checks for a byte-order mark at the beginning of the stream.

  3. Se a propriedade Encoding for null e nenhuma marca de ordem de byte for encontrada, o leitor assumirá que o fluxo está codificado em UTF-8.If the Encoding property is null, and no byte-order mark is found, the reader assumes the stream is encoded in UTF-8.

Veja também

XmlTextReader(String, TextReader)

Inicializa uma nova instância da classe XmlTextReader com a URL especificada e TextReader.Initializes a new instance of the XmlTextReader class with the specified URL and 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

A URL a ser usada para resolver recursos externos.The URL to use for resolving external resources. O BaseURI é definido para esse valor.The BaseURI is set to this value.

input
TextReader

O TextReader que contém os dados XML a serem lidos.The TextReader containing the XML data to read.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Supõe-se que TextReader já esteja definido como a codificação correta.It is assumed that the TextReader is already set to the correct encoding. Isso é usado por clientes que já lêem algumas coisas do fluxo em um cenário MIME de várias partes.This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

Veja também

XmlTextReader(String, Stream)

Inicializa uma nova instância da classe XmlTextReader com a URL e o fluxo especificados.Initializes a new instance of the XmlTextReader class with the specified URL and stream.

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

A URL a ser usada para resolver recursos externos.The URL to use for resolving external resources. O BaseURI é definido para esse valor.The BaseURI is set to this value.

input
Stream

O fluxo que contém os dados XML a serem lidos.The stream containing the XML data to read.

Exceções

input é null.input is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Veja também

XmlTextReader(String, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified file and 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

A URL do arquivo que contém os dados XML a serem lidos.The URL for the file containing the XML data to read.

nt
XmlNameTable

O XmlNameTable a ser usado.The XmlNameTable to use.

Exceções

O valor nt é null.The nt value is null.

Não foi possível localizar o arquivo especificado.The specified file cannot be found.

Parte do nome de arquivo ou diretório não pôde ser encontrada.Part of the filename or directory cannot be found.

url é uma cadeia de caracteres vazia.url is an empty string.

O nome de arquivo remoto não pode ser resolvido.The remote filename cannot be resolved.

- ou --or-

Ocorreu um erro ao processar a solicitação.An error occurred while processing the request.

url não é um URI válido.url is not a valid URI.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Veja também

XmlTextReader(Stream, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado e XmlNameTable.Initializes a new instance of the XmlTextReader class with the specified stream and 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 a serem lidos.The stream containing the XML data to read.

nt
XmlNameTable

O XmlNameTable a ser usado.The XmlNameTable to use.

Exceções

O valor input ou nt é null.The input or nt value is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

O XmlTextReader decodifica o fluxo usando System.Text.Encoding.The XmlTextReader decodes the stream using System.Text.Encoding.

Se você especificar uma tabela de nome, esse construtor usará os nomes definidos já existentes nessa tabela.If you specify a name table, this constructor uses the names defined already in that table.

Veja também

XmlTextReader(XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o XmlNameTable especificado.Initializes a new instance of the XmlTextReader class with the specified 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 a ser usado.The XmlNameTable to use.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Veja também

XmlTextReader(String)

Inicializa uma nova instância da classe XmlTextReader com o arquivo especificado.Initializes a new instance of the XmlTextReader class with the specified file.

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

A URL do arquivo que contém os dados XML.The URL for the file containing the XML data. O BaseURI é definido para esse valor.The BaseURI is set to this value.

Exceções

Não foi possível localizar o arquivo especificado.The specified file cannot be found.

Parte do nome de arquivo ou diretório não pôde ser encontrada.Part of the filename or directory cannot be found.

url é uma cadeia de caracteres vazia.url is an empty string.

O nome de arquivo remoto não pode ser resolvido.The remote filename cannot be resolved.

- ou --or-

Ocorreu um erro ao processar a solicitação.An error occurred while processing the request.

url não é um URI válido.url is not a valid URI.

Exemplos

O exemplo a seguir lê um arquivo XML e exibe cada um dos nós.The following example reads an XML file and displays each of the nodes.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = nullptr;
   String^ filename = "items.xml";
   try
   {
      
      // Load the reader with the data file and ignore all white space nodes.         
      reader = gcnew 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 != nullptr )
            reader->Close();
   }

}

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 arquivo, items.xml, como entrada.The example uses the file, items.xml, as input.


<?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: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Se o arquivo estiver localizado em um recurso que requer credenciais de acesso, use a propriedade XmlResolver para especificar as credenciais necessárias.If the file is located on a resource that requires access credentials, use the XmlResolver property to specify the necessary credentials.

Observação

Na versão 1,1 do .NET Framework.NET Framework, o código parcialmente confiável não pode definir a propriedade XmlResolver.In version 1.1 of the .NET Framework.NET Framework, partially trusted code cannot set the XmlResolver property. A solução alternativa é criar um XmlUrlResolver com as credenciais necessárias, passar o URI para o método XmlUrlResolver.GetEntity e, em seguida, construir o XmlTextReader usando o objeto Stream resultante.The workaround is to create an XmlUrlResolver with the necessary credentials, pass the URI to the XmlUrlResolver.GetEntity method, and then construct the XmlTextReader using the resulting Stream object. A solução alternativa é descrita no código C# a seguir.The workaround is described in the following C# code.

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

Veja também

XmlTextReader(TextReader)

Inicializa uma nova instância da classe XmlTextReader com o TextReader especificado.Initializes a new instance of the XmlTextReader class with the specified 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 a serem lidos.The TextReader containing the XML data to read.

Exemplos

O exemplo a seguir carrega uma cadeia de caracteres XML no objeto XmlTextReader usando a classe StringReader.The following example loads an XML string into the XmlTextReader object using the StringReader class.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   String^ xmlData = "<book>\r\n       <title>Oberon's Legacy</title>\r\n       <price>5.95</price>\r\n      </book>";
   
   // Create the reader.
   XmlTextReader^ reader = gcnew XmlTextReader( gcnew 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();
}

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

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Supõe-se que TextReader já esteja definido como a codificação correta.It is assumed that the TextReader is already set to the correct encoding. Isso é usado por clientes que já lêem algumas coisas do fluxo em um cenário MIME de várias partes.This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

Veja também

XmlTextReader(Stream)

Inicializa uma nova instância da classe XmlTextReader com o fluxo especificado.Initializes a new instance of the XmlTextReader class with the specified stream.

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 a serem lidos.The stream containing the XML data to read.

Exceções

input é null.input is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

O XmlTextReader decodifica o fluxo usando System.Text.Encoding.The XmlTextReader decodes the stream using System.Text.Encoding.

Veja também

XmlTextReader(TextReader, XmlNameTable)

Inicializa uma nova instância da classe XmlTextReader com o TextReader e XmlNameTable especificados.Initializes a new instance of the XmlTextReader class with the specified TextReader and 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 a serem lidos.The TextReader containing the XML data to read.

nt
XmlNameTable

O XmlNameTable a ser usado.The XmlNameTable to use.

Exceções

O valor nt é null.The nt value is null.

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie instâncias de XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

Supõe-se que TextReader já esteja definido como a codificação correta.It is assumed that the TextReader is already set to the correct encoding. Isso é usado por clientes que já lêem algumas coisas do fluxo em um cenário MIME de várias partes.This is used by clients that have already read some things from the stream in a multi-part MIME scenario.

Veja também

Aplica-se a