XmlReader.ReadStartElement Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
netstandard.dll

Kontrollerar att den aktuella noden är ett element och flyttar läsaren till nästa nod.

Överlagringar

Name Description
ReadStartElement()

Kontrollerar att den aktuella noden är ett element och flyttar läsaren till nästa nod.
ReadStartElement(String)

Kontrollerar att den aktuella innehållsnoden är ett element med angivet Name och avancerar läsaren till nästa nod.
ReadStartElement(String, String)

Kontrollerar att den aktuella innehållsnoden är ett element med angivet LocalName och NamespaceURI avancerar läsaren till nästa nod.

ReadStartElement()

Kontrollerar att den aktuella noden är ett element och flyttar läsaren till nästa nod.

public:
 virtual void ReadStartElement();
public virtual void ReadStartElement();
abstract member ReadStartElement : unit -> unit
override this.ReadStartElement : unit -> unit
Public Overridable Sub ReadStartElement ()

Undantag

XmlException

Felaktig XML påträffades i indataströmmen.

InvalidOperationException

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Kommentarer

Den här metoden anropar IsStartElement följt av Read för att placera dig på innehållet i elementet som finns i indataströmmen.

Se även

Gäller för

ReadStartElement(String)

Kontrollerar att den aktuella innehållsnoden är ett element med angivet Name och avancerar läsaren till nästa nod.

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)

Parametrar

name
String

Elementets kvalificerade namn.

Undantag

XmlException

Felaktig XML påträffades i indataströmmen.

-eller-

Elementet Name matchar inte den angivna name.

InvalidOperationException

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Exempel

I följande exempel visas textinnehållet för varje element.

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

I exemplet används book3.xml filen.

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

Kommentarer

Ett anrop till den här metoden motsvarar ett anrop till IsStartElement följt av ett anrop till Read.

Se även

Gäller för

ReadStartElement(String, String)

Kontrollerar att den aktuella innehållsnoden är ett element med angivet LocalName och NamespaceURI avancerar läsaren till nästa nod.

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)

Parametrar

localname
String

Elementets lokala namn.

ns
String

Elementets namnområdes-URI.

Undantag

XmlException

Felaktig XML påträffades i indataströmmen.

-eller-

Egenskaperna LocalName och NamespaceURI för elementet som hittades matchar inte de angivna argumenten.

InvalidOperationException

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Kommentarer

Ett anrop till den här metoden motsvarar ett anrop till IsStartElement följt av ett anrop till Read.

Se även

Gäller för