XmlReader.ReadStartElement Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Sprawdza, czy bieżący węzeł jest elementem i przechodzi czytelnika do następnego węzła.

Przeciążenia

ReadStartElement()	Sprawdza, czy bieżący węzeł jest elementem i przechodzi czytelnika do następnego węzła.
ReadStartElement(String)	Sprawdza, czy bieżący węzeł zawartości jest elementem z daną wartością Name i przechodzi czytelnika do następnego węzła.
ReadStartElement(String, String)	Sprawdza, czy bieżący węzeł zawartości jest elementem z daną wartością LocalName i NamespaceURI przechodzi czytelnika do następnego węzła.

ReadStartElement()

Sprawdza, czy bieżący węzeł jest elementem i przechodzi czytelnika do następnego węzła.

public:
 virtual void ReadStartElement();

public virtual void ReadStartElement ();

abstract member ReadStartElement : unit -> unit
override this.ReadStartElement : unit -> unit

Public Overridable Sub ReadStartElement ()

Wyjątki

XmlException

Napotkano niepoprawny kod XML w strumieniu wejściowym.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda wywołuje następujące Read wywołaniaIsStartElement, aby umieścić użytkownika na zawartości tego elementu znajdującego się w strumieniu wejściowym.

Zobacz też

• ReadEndElement()

ReadStartElement(String)

Sprawdza, czy bieżący węzeł zawartości jest elementem z daną wartością Name i przechodzi czytelnika do następnego węzła.

public:
 virtual void ReadStartElement(System::String ^ name);

public virtual void ReadStartElement (string name);

abstract member ReadStartElement : string -> unit
override this.ReadStartElement : string -> unit

Public Overridable Sub ReadStartElement (name As String)

Parametry

name

String

Kwalifikowana nazwa elementu.

Wyjątki

XmlException

Napotkano niepoprawny kod XML w strumieniu wejściowym.

-lub-

Element Name elementu nie jest zgodny z danym nameelementem .

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

W poniższym przykładzie jest wyświetlana zawartość tekstowa każdego elementu.

using (XmlReader reader = XmlReader.Create("book3.xml")) {

  // Parse the XML document.  ReadString is used to
  // read the text content of the elements.
  reader.Read();
  reader.ReadStartElement("book");
  reader.ReadStartElement("title");
  Console.Write("The content of the title element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadStartElement("price");
  Console.Write("The content of the price element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadEndElement();
}

Using reader As XmlReader = XmlReader.Create("book3.xml")               
  ' Parse the XML document.  ReadString is used to 
  ' read the text content of the elements.
  reader.Read()
  reader.ReadStartElement("book")
  reader.ReadStartElement("title")
  Console.Write("The content of the title element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadStartElement("price")
  Console.Write("The content of the price element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadEndElement()            
End Using

W przykładzie użyto book3.xml pliku.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
</book>

Uwagi

Wywołanie tej metody odpowiada wywołaniu, po IsStartElement którym następuje wywołanie metody Read.

Zobacz też

• ReadEndElement()

ReadStartElement(String, String)

Sprawdza, czy bieżący węzeł zawartości jest elementem z daną wartością LocalName i NamespaceURI przechodzi czytelnika do następnego węzła.

public:
 virtual void ReadStartElement(System::String ^ localname, System::String ^ ns);

public virtual void ReadStartElement (string localname, string ns);

abstract member ReadStartElement : string * string -> unit
override this.ReadStartElement : string * string -> unit

Public Overridable Sub ReadStartElement (localname As String, ns As String)

Parametry

localname

String

Lokalna nazwa elementu.

ns

String

Identyfikator URI przestrzeni nazw elementu.

Wyjątki

XmlException

Napotkano niepoprawny kod XML w strumieniu wejściowym.

-lub-

Właściwości LocalName i NamespaceURI znalezionego elementu nie są zgodne z podanymi argumentami.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Wywołanie tej metody odpowiada wywołaniu, po IsStartElement którym następuje wywołanie metody Read.

Zobacz też

• ReadEndElement()