XmlReader.IsStartElement Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Testet, ob der aktuelle Inhaltsknoten ein Starttag ist.
Überlädt
| Name | Beschreibung |
|---|---|
| IsStartElement(String, String) |
Aufrufe MoveToContent() und Tests, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und ob die und LocalName die NamespaceURI Eigenschaften des Elements gefunden wurden, mit den angegebenen Zeichenfolgen übereinstimmen. |
| IsStartElement() |
Ruft auf und testet MoveToContent() , ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist. |
| IsStartElement(String) |
Aufrufe MoveToContent() und Tests, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und ob die Name Eigenschaft des gefundenen Elements mit dem angegebenen Argument übereinstimmt. |
IsStartElement(String, String)
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Aufrufe MoveToContent() und Tests, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und ob die und LocalName die NamespaceURI Eigenschaften des Elements gefunden wurden, 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 Zeichenfolge, die mit der LocalName Eigenschaft des gefundenen Elements übereinstimmt.
- ns
- String
Die Zeichenfolge, die mit der NamespaceURI Eigenschaft des gefundenen Elements übereinstimmt.
Gibt zurück
true wenn der resultierende Knoten ein Element ist.
false wenn ein anderer Knotentyp als XmlNodeType.Element gefunden wurde oder die LocalName Eigenschaften NamespaceURI des Elements nicht mit den angegebenen Zeichenfolgen übereinstimmen.
Ausnahmen
Im Eingabedatenstrom ist ein falscher XML-Code aufgetreten.
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 der aktuelle Knoten ein Element ist.
Weitere Informationen
Gilt für:
IsStartElement()
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Ruft auf und testet MoveToContent() , 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
true wenn MoveToContent() ein Starttag oder ein leeres Elementtag gefunden wird; false wenn ein anderer Knotentyp als XmlNodeType.Element gefunden wurde.
Ausnahmen
Im Eingabedatenstrom ist ein falscher XML-Code aufgetreten.
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 der aktuelle Knoten ein Element ist.
Weitere Informationen
Gilt für:
IsStartElement(String)
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
- Quelle:
- XmlReader.cs
Aufrufe MoveToContent() und Tests, ob der aktuelle Inhaltsknoten ein Starttag oder ein leeres Elementtag ist und ob 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 Zeichenfolge, die mit der Name Eigenschaft des gefundenen Elements übereinstimmt.
Gibt zurück
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 Elementeigenschaft Name nicht mit der angegebenen Zeichenfolge übereinstimmt.
Ausnahmen
Im Eingabedatenstrom ist ein falscher XML-Code aufgetreten.
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 der aktuelle Knoten ein Element ist.