XmlReader.IsStartElement Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Überprüft, ob der aktuelle Inhaltsknoten ein Starttag ist.

Überlädt

IsStartElement(String, String)	Ruft MoveToContent() auf und überprüft, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und ob die LocalName-Eigenschaft und die NamespaceURI-Eigenschaft des gefundenen Elements mit den angegebenen Zeichenfolgen übereinstimmen.
IsStartElement()	Ruft MoveToContent() auf und überprüft, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist.
IsStartElement(String)	Ruft MoveToContent() auf und überprüft, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und die Name-Eigenschaft des gefundenen Elements mit dem angegebenen Argument übereinstimmt.

IsStartElement(String, String)

Source:

XmlReader.cs

Ruft MoveToContent() auf und überprüft, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und ob die LocalName-Eigenschaft und die NamespaceURI-Eigenschaft des gefundenen Elements mit den angegebenen Zeichenfolgen übereinstimmen.

public:
 virtual bool IsStartElement(System::String ^ localname, System::String ^ ns);

public virtual bool IsStartElement (string localname, string ns);

abstract member IsStartElement : string * string -> bool
override this.IsStartElement : string * string -> bool

Public Overridable Function IsStartElement (localname As String, ns As String) As Boolean

Parameter

localname

String

Die mit der LocalName-Eigenschaft des gefundenen Elements zu vergleichende Zeichenfolge.

ns

String

Die mit der NamespaceURI-Eigenschaft des gefundenen Elements zu vergleichende Zeichenfolge.

Gibt zurück

Boolean

true, wenn der resultlierende Knoten ein Element ist. false, wenn ein anderer Knotentyp als XmlNodeType.Element gefunden wurde oder die LocalName-Eigenschaft und die NamespaceURI-Eigenschaft des Elements nicht mit den angegebenen Zeichenfolgen übereinstimmen.

Ausnahmen

XmlException

Im Eingabestream wurde unzulässiger XML-Code gefunden.

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

Diese Methode überspringt Leerzeichen, Kommentare und Verarbeitungsanweisungen, bis der Leser auf einem Inhaltsknoten positioniert ist. Die -Methode testet dann, ob es sich bei dem aktuellen Knoten um ein Element handelt.

Weitere Informationen

• MoveToContent()

IsStartElement()

Source:

XmlReader.cs

Ruft MoveToContent() auf und überprüft, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist.

public:
 virtual bool IsStartElement();

public virtual bool IsStartElement ();

abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool

Public Overridable Function IsStartElement () As Boolean

Gibt zurück

Boolean

true, wenn MoveToContent() ein Starttag oder ein leeres Elementtag findet. false, wenn ein anderer Knotentyp als XmlNodeType.Element gefunden wurde.

Ausnahmen

XmlException

Im Eingabestream wurde unzulässiger XML-Code gefunden.

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im folgenden Beispiel wird der Textinhalt der einzelnen Elemente angezeigt.

while (reader.Read()) {
  if (reader.IsStartElement()) {
    if (reader.IsEmptyElement)
                {
                    Console.WriteLine("<{0}/>", reader.Name);
                }
                else {
      Console.Write("<{0}> ", reader.Name);
      reader.Read(); // Read the start tag.
      if (reader.IsStartElement())  // Handle nested elements.
        Console.Write("\r\n<{0}>", reader.Name);
      Console.WriteLine(reader.ReadString());  //Read the text content of the element.
    }
  }
}

While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
    Else
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

Im Beispiel wird die Datei als elems.xmlEingabe verwendet.

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

Hinweise

Diese Methode überspringt Leerzeichen, Kommentare und Verarbeitungsanweisungen, bis der Leser auf einem Inhaltsknoten positioniert ist. Die -Methode testet dann, ob es sich bei dem aktuellen Knoten um ein Element handelt.

Weitere Informationen

• MoveToContent()

IsStartElement(String)

Source:

XmlReader.cs

Ruft MoveToContent() auf und überprüft, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und die Name-Eigenschaft des gefundenen Elements mit dem angegebenen Argument übereinstimmt.

public:
 virtual bool IsStartElement(System::String ^ name);

public virtual bool IsStartElement (string name);

abstract member IsStartElement : string -> bool
override this.IsStartElement : string -> bool

Public Overridable Function IsStartElement (name As String) As Boolean

Parameter

name

String

Die mit der Name-Eigenschaft des gefundenen Elements verglichene Zeichenfolge.

Gibt zurück

Boolean

true, wenn der resultierende Knoten ein Element ist und die Name-Eigenschaft mit der angegebenen Zeichenfolge übereinstimmt. false, wenn ein anderer Knotentyp als XmlNodeType.Element gefunden wurde oder die Name-Elementeigenschaft nicht mit der angegebenen Zeichenfolge übereinstimmt.

Ausnahmen

XmlException

Im Eingabestream wurde unzulässiger XML-Code gefunden.

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im folgenden Beispiel werden die einzelnen Preiselemente angezeigt.

// Parse the file and display each price node.
while (reader.Read()) {
  if (reader.IsStartElement("price")) {
     Console.WriteLine(reader.ReadInnerXml());
  }
}

' Parse the file and display each price node.
While reader.Read()
  If reader.IsStartElement("price") Then
    Console.WriteLine(reader.ReadInnerXml())
  End If
End While

Hinweise

Diese Methode überspringt Leerzeichen, Kommentare und Verarbeitungsanweisungen, bis der Leser auf einem Inhaltsknoten positioniert ist. Die -Methode testet dann, ob es sich bei dem aktuellen Knoten um ein Element handelt.

Weitere Informationen

• MoveToContent()