XmlTextReader Konstruktory

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Inicjuje nowe wystąpienie klasy XmlTextReader.

Przeciążenia

Nazwa	Opis
XmlTextReader()	Inicjuje nowe wystąpienie klasy XmlTextReader.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego ciągu, XmlNodeTypei XmlParserContext.
XmlTextReader(String, TextReader, XmlNameTable)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL TextReader i XmlNameTable.
XmlTextReader(String, Stream, XmlNameTable)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL, strumienia i XmlNameTable.
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego strumienia, XmlNodeTypei XmlParserContext.
XmlTextReader(String, TextReader)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL i TextReader.
XmlTextReader(String, Stream)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL i strumienia.
XmlTextReader(String, XmlNameTable)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego pliku i XmlNameTable.
XmlTextReader(Stream, XmlNameTable)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego strumienia i XmlNameTable.
XmlTextReader(XmlNameTable)	Inicjuje nowe wystąpienie klasy XmlTextReader z określonym XmlNameTable.
XmlTextReader(String)	Inicjuje XmlTextReader nowe wystąpienie klasy przy użyciu określonego pliku.
XmlTextReader(TextReader)	Inicjuje nowe wystąpienie klasy XmlTextReader z określonym TextReader.
XmlTextReader(Stream)	Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego strumienia.
XmlTextReader(TextReader, XmlNameTable)	Inicjuje nowe wystąpienie XmlTextReader klasy z określonymi TextReader parametrami i XmlNameTable.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

XmlTextReader()

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie klasy XmlTextReader.

protected:
 XmlTextReader();

protected XmlTextReader();

Protected Sub New ()

Zobacz też

• XmlReader

XmlTextReader(String, XmlNodeType, XmlParserContext)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego ciągu, XmlNodeTypei 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)

Parametry

xmlFragment

String

Ciąg zawierający fragment XML do przeanalizowana.

fragType

XmlNodeType

Fragment XmlNodeType XML. Określa również, co może zawierać ciąg fragmentu. (Zobacz tabelę poniżej).

context

XmlParserContext

Element XmlParserContext , w którym element xmlFragment ma zostać przeanalizowany. Obejmuje XmlNameTable to użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:langzakres i xml:space zakres.

Wyjątki

XmlException

fragType nie jest elementem Element, Attributelub DocumentXmlNodeType.

ArgumentNullException

Parametr xmlFragment ma wartość null.

Przykłady

Poniższy przykład analizuje fragment XML. Używa elementu XmlParserContext i , XmlNamespaceManager aby obsługiwać rozpoznawanie przestrzeni nazw.

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

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Ten konstruktor analizuje dany ciąg jako fragment kodu XML. Jeśli fragment XML jest elementem lub atrybutem, można pominąć reguły poziomu głównego dla dobrze sformułowanych dokumentów XML. Ten konstruktor może obsługiwać ciągi zwracane z ReadInnerXml.

W poniższej tabeli wymieniono prawidłowe wartości i fragType sposób analizowania poszczególnych typów węzłów przez czytelnika.

XmlNodeType	Fragment może zawierać
Składnik	Dowolna prawidłowa zawartość elementu (na przykład dowolna kombinacja elementów, komentarzy, instrukcji przetwarzania, sekcje CDATA, tekst i odwołania do jednostek). Można również podać deklarację XML. Dzięki temu można określić kodowanie fragmentu XML, zamiast ustawiać go na XmlParserContext obiekcie.
Atrybut	Wartość atrybutu (część wewnątrz cudzysłowów).
Dokument	Zawartość całego dokumentu XML. Wymusza to reguły na poziomie dokumentu.

Zobacz też

• XmlParserContext
• XmlReader

XmlTextReader(String, TextReader, XmlNameTable)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL TextReader i 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)

Parametry

url

String

Adres URL używany do rozpoznawania zasobów zewnętrznych. Parametr BaseURI jest ustawiony na tę wartość. Jeśli url parametr ma nullwartość , BaseURI ma wartość String.Empty.

input

TextReader

Zawierające TextReader dane XML do odczytania.

nt

XmlNameTable

XmlNameTable do użycia.

Wyjątki

ArgumentNullException

Wartość nt to null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zakłada się, że TextReader właściwość jest już ustawiona na poprawne kodowanie. Jest to używane przez klientów, którzy już odczytywali niektóre elementy ze strumienia w wieloczęściowym scenariuszu MIME.

Zobacz też

• XmlReader

XmlTextReader(String, Stream, XmlNameTable)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL, strumienia i 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)

Parametry

url

String

Adres URL używany do rozpoznawania zasobów zewnętrznych. Parametr BaseURI jest ustawiony na tę wartość. Jeśli url parametr ma nullwartość , BaseURI ma wartość String.Empty.

input

Stream

Strumień zawierający dane XML do odczytania.

nt

XmlNameTable

XmlNameTable do użycia.

Wyjątki

NullReferenceException

Wartość input lub nt to null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zobacz też

• XmlReader

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego strumienia, XmlNodeTypei 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)

Parametry

xmlFragment

Stream

Strumień zawierający fragment XML do przeanalizowana.

fragType

XmlNodeType

Fragment XmlNodeType XML. Określa to również, co może zawierać fragment. (Zobacz tabelę poniżej).

context

XmlParserContext

Element XmlParserContext , w którym element xmlFragment ma zostać przeanalizowany. Obejmuje XmlNameTable to użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:langzakres i xml:space zakres.

Wyjątki

XmlException

fragType nie jest elementem, atrybutem ani dokumentem XmlNodeType.

ArgumentNullException

Parametr xmlFragment ma wartość null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Ten konstruktor analizuje dany ciąg jako fragment kodu XML. Jeśli fragment XML jest elementem lub atrybutem, można pominąć reguły poziomu głównego dla dobrze sformułowanych dokumentów XML.

W poniższej tabeli wymieniono prawidłowe wartości dla elementu fragType.

XmlNodeType	Fragment może zawierać
Element	Dowolna prawidłowa zawartość elementu (na przykład dowolna kombinacja elementów, komentarzy, instrukcji przetwarzania, sekcje CDATA, tekst i odwołania do jednostek). Można również podać deklarację XML. Dzięki temu można określić kodowanie fragmentu XML, zamiast ustawiać go na XmlParserContext obiekcie.
Attribute	Wartość atrybutu (część wewnątrz cudzysłowów).
Document	Zawartość całego dokumentu XML. Wymusza to reguły na poziomie dokumentu.

Czytelnik używa następującej metody do określenia kodowania strumienia.

1. Sprawdza właściwość w XmlParserContext.Encoding celu określenia kodowania.

2. Encoding Jeśli właściwość to null, czytelnik sprawdza znacznik kolejności bajtów na początku strumienia.

3. Encoding Jeśli właściwość ma nullwartość , a nie znaleziono żadnego znacznika kolejności bajtów, czytelnik zakłada, że strumień jest zakodowany w formacie UTF-8.

Zobacz też

• XmlReader

XmlTextReader(String, TextReader)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL i 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)

Parametry

url

String

Adres URL używany do rozpoznawania zasobów zewnętrznych. Parametr BaseURI jest ustawiony na tę wartość.

input

TextReader

Zawierające TextReader dane XML do odczytania.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zakłada się, że TextReader właściwość jest już ustawiona na poprawne kodowanie. Jest to używane przez klientów, którzy już odczytywali niektóre elementy ze strumienia w wieloczęściowym scenariuszu MIME.

Zobacz też

• XmlReader

XmlTextReader(String, Stream)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego adresu URL i strumienia.

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)

Parametry

url

String

Adres URL używany do rozpoznawania zasobów zewnętrznych. Parametr BaseURI jest ustawiony na tę wartość.

input

Stream

Strumień zawierający dane XML do odczytania.

Wyjątki

ArgumentNullException

Parametr input ma wartość null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zobacz też

• XmlReader

XmlTextReader(String, XmlNameTable)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego pliku i 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)

Parametry

url

String

Adres URL pliku zawierającego dane XML do odczytania.

nt

XmlNameTable

XmlNameTable do użycia.

Wyjątki

NullReferenceException

Wartość nt to null.

FileNotFoundException

Nie można odnaleźć określonego pliku.

DirectoryNotFoundException

Nie można odnaleźć części nazwy pliku lub katalogu.

InvalidOperationException

url jest pustym ciągiem.

WebException

Nie można rozpoznać nazwy pliku zdalnego.

— lub —

Wystąpił błąd podczas przetwarzania żądania.

UriFormatException

url nie jest prawidłowym identyfikatorem URI.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zobacz też

• XmlReader

XmlTextReader(Stream, XmlNameTable)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego strumienia i 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)

Parametry

input

Stream

Strumień zawierający dane XML do odczytania.

nt

XmlNameTable

XmlNameTable do użycia.

Wyjątki

NullReferenceException

Wartość input lub nt to null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Dekoduje XmlTextReader strumień przy użyciu polecenia System.Text.Encoding.

Jeśli określisz tabelę nazw, ten konstruktor używa nazw zdefiniowanych już w tej tabeli.

Zobacz też

• XmlReader

XmlTextReader(XmlNameTable)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie klasy XmlTextReader z określonym 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)

Parametry

nt

XmlNameTable

XmlNameTable do użycia.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zobacz też

• XmlReader

XmlTextReader(String)

Źródło:

XmlTextReader.cs

Inicjuje XmlTextReader nowe wystąpienie klasy przy użyciu określonego pliku.

public:
 XmlTextReader(System::String ^ url);

public XmlTextReader(string url);

new System.Xml.XmlTextReader : string -> System.Xml.XmlTextReader

Public Sub New (url As String)

Parametry

url

String

Adres URL pliku zawierającego dane XML. Parametr BaseURI jest ustawiony na tę wartość.

Wyjątki

FileNotFoundException

Nie można odnaleźć określonego pliku.

DirectoryNotFoundException

Nie można odnaleźć części nazwy pliku lub katalogu.

InvalidOperationException

url jest pustym ciągiem.

WebException

Nie można rozpoznać nazwy pliku zdalnego.

— lub —

Wystąpił błąd podczas przetwarzania żądania.

UriFormatException

url nie jest prawidłowym identyfikatorem URI.

Przykłady

Poniższy przykład odczytuje plik XML i wyświetla każdy z węzłów.

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

W przykładzie użyto pliku , items.xmljako danych wejściowych.

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

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Jeśli plik znajduje się w zasobie, który wymaga poświadczeń dostępu, użyj XmlResolver właściwości , aby określić niezbędne poświadczenia.

Uwaga / Notatka

W wersji 1.1 programu .NET Framework częściowo zaufany kod nie może ustawić XmlResolver właściwości . Obejście polega na utworzeniu obiektu XmlUrlResolver z wymaganymi poświadczeniami, przekazaniu identyfikatora URI do XmlUrlResolver.GetEntity metody, a następnie utworzeniu XmlTextReader obiektu wynikowego przy użyciu obiektu wynikowego Stream . Obejście zostało opisane w poniższym kodzie języka 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);

Zobacz też

• XmlResolver
• XmlReader

XmlTextReader(TextReader)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie klasy XmlTextReader z określonym 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)

Parametry

input

TextReader

Zawierające TextReader dane XML do odczytania.

Przykłady

Poniższy przykład ładuje ciąg XML do XmlTextReader obiektu przy użyciu StringReader klasy .

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

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zakłada się, że TextReader właściwość jest już ustawiona na poprawne kodowanie. Jest to używane przez klientów, którzy już odczytywali niektóre elementy ze strumienia w wieloczęściowym scenariuszu MIME.

Zobacz też

• XmlReader

XmlTextReader(Stream)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy przy użyciu określonego strumienia.

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)

Parametry

input

Stream

Strumień zawierający dane XML do odczytania.

Wyjątki

ArgumentNullException

Parametr input ma wartość null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Dekoduje XmlTextReader strumień przy użyciu polecenia System.Text.Encoding.

Zobacz też

• XmlReader

XmlTextReader(TextReader, XmlNameTable)

Źródło:

XmlTextReader.cs

Inicjuje nowe wystąpienie XmlTextReader klasy z określonymi TextReader parametrami i 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)

Parametry

input

TextReader

Zawierające TextReader dane XML do odczytania.

nt

XmlNameTable

XmlNameTable do użycia.

Wyjątki

NullReferenceException

Wartość nt to null.

Uwagi

Uwaga / Notatka

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Zakłada się, że TextReader właściwość jest już ustawiona na poprawne kodowanie. Jest to używane przez klientów, którzy już odczytywali niektóre elementy ze strumienia w wieloczęściowym scenariuszu MIME.

Zobacz też

• XmlReader