XmlReader.ReadStartElement Metoda

Definicja

Sprawdza, czy bieżący węzeł jest elementem i przesuwa czytnik do następnego węzła.Checks that the current node is an element and advances the reader to the next node.

Przeciążenia

ReadStartElement()

Sprawdza, czy bieżący węzeł jest elementem i przesuwa czytnik do następnego węzła.Checks that the current node is an element and advances the reader to the next node.

ReadStartElement(String)

Sprawdza, czy bieżący węzeł zawartości jest elementem z daną Name i przechodzi do następnego węzła.Checks that the current content node is an element with the given Name and advances the reader to the next node.

ReadStartElement(String, String)

Sprawdza, czy bieżący węzeł zawartości jest elementem z daną LocalName i NamespaceURI i przechodzenie do następnego węzła.Checks that the current content node is an element with the given LocalName and NamespaceURI and advances the reader to the next node.

ReadStartElement()

Sprawdza, czy bieżący węzeł jest elementem i przesuwa czytnik do następnego węzła.Checks that the current node is an element and advances the reader to the next node.

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

Wyjątki

Napotkano nieprawidłowy kod XML w strumieniu wejściowym.Incorrect XML was encountered in the input stream.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Uwagi

Ta metoda wywołuje IsStartElement po którym następuje Read, aby pomieścić zawartość tego elementu w strumieniu wejściowym.This method calls IsStartElement followed by Read to position you on the content of that element found in the input stream.

Zobacz też

ReadStartElement(String)

Sprawdza, czy bieżący węzeł zawartości jest elementem z daną Name i przechodzi do następnego węzła.Checks that the current content node is an element with the given Name and advances the reader to the next node.

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.The qualified name of the element.

Wyjątki

Napotkano nieprawidłowy kod XML w strumieniu wejściowym.Incorrect XML was encountered in the input stream.

— lub —-or- Name elementu nie pasuje do podaną name.The Name of the element does not match the given name.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Przykłady

Poniższy przykład wyświetla zawartość tekstową każdego elementu.The following example displays the text content of each 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

W przykładzie zastosowano plik book3.xml.The example uses the book3.xml file.

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

Uwagi

Wywołanie tej metody odnosi się do wywołania IsStartElement, po którym następuje wywołanie Read.A call to this method corresponds to a call to IsStartElement followed by a call to Read.

Zobacz też

ReadStartElement(String, String)

Sprawdza, czy bieżący węzeł zawartości jest elementem z daną LocalName i NamespaceURI i przechodzenie do następnego węzła.Checks that the current content node is an element with the given LocalName and NamespaceURI and advances the reader to the next node.

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

Nazwa lokalna elementu.The local name of the element.

ns
String

Identyfikator URI przestrzeni nazw elementu.The namespace URI of the element.

Wyjątki

Napotkano nieprawidłowy kod XML w strumieniu wejściowym.Incorrect XML was encountered in the input stream.

— lub —-or- Właściwości LocalName i NamespaceURI elementu znaleziono niezgodne z podanym argumentami.The LocalName and NamespaceURI properties of the element found do not match the given arguments.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Uwagi

Wywołanie tej metody odnosi się do wywołania IsStartElement, po którym następuje wywołanie Read.A call to this method corresponds to a call to IsStartElement followed by a call to Read.

Zobacz też

Dotyczy