XmlReader.MoveToContent-Methode
Überprüft, ob der aktuelle Knoten ein Inhaltsknoten (Textknoten ohne Leerraum, CDATA-, Element-, EndElement-, EntityReference- oder EndEntity-Knoten) ist. Wenn der Knoten kein Inhaltsknoten ist, springt der Reader zum nächsten Inhaltsknoten oder an das Ende der Datei. Knoten folgender Typen werden übersprungen: ProcessingInstruction, DocumentType, Comment, Whitespace und SignificantWhitespace.
Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)
Syntax
'Declaration
Public Overridable Function MoveToContent As XmlNodeType
'Usage
Dim instance As XmlReader
Dim returnValue As XmlNodeType
returnValue = instance.MoveToContent
public virtual XmlNodeType MoveToContent ()
public:
virtual XmlNodeType MoveToContent ()
public XmlNodeType MoveToContent ()
public function MoveToContent () : XmlNodeType
Rückgabewert
Der NodeType des von der Methode gefundenen aktuellen Knotens oder XmlNodeType.None, wenn der Reader das Ende des Eingabestreams erreicht hat.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Im Eingabestream wurde unzulässiger XML-Code gefunden. |
Hinweise
Wenn der aktuelle Knoten ein Attributknoten ist, verschiebt diese Methode den Reader zurück auf das Element, das das Attribut besitzt.
Beispiel
Dies bietet sich an, wenn Sie Code schreiben möchten, der nach dem Zufallsprinzip generiertes XML-Markup überspringen kann, ohne Fehler zu erzeugen. Nehmen Sie z. B. an, dass folgender Code vorliegt:
If reader.MoveToContent() = XmlNodeType.Element And reader.Name = "price" Then
_price = reader.ReadString()
End If
if (reader.MoveToContent() == XmlNodeType.Element && reader.Name == "price")
{
_price = reader.ReadString();
}
if ( reader->MoveToContent() == XmlNodeType::Element &&
reader->Name->Equals( "price" ) )
{
_price = reader->ReadString();
}
if (reader.MoveToContent().Equals(XmlNodeType.Element) &&
reader.get_Name().Equals("price")) {
_price = reader.ReadString();
}
Dieser Code kann die folgenden Eingaben behandeln, ohne Fehler zu generieren:
<price>123.4</price>
und
<?xml version="1.0"><!DOCTYPE price SYSTEM
"abc"><price>123.4</price>
und
<?xml version="1.0"><!DOCTYPE price SYSTEM "abc"
[<!ENTTIY p
"123.4">]><price>&p;</price>
und
<!-- some test comment --><?processing
instruction?><price>123.4</price>
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
XmlReader-Klasse
XmlReader-Member
System.Xml-Namespace