Freigeben über


XmlNodeReader.HasValue-Eigenschaft

Ruft einen Wert ab, der angibt, ob der aktuelle Knoten einen Value aufweisen darf.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overrides ReadOnly Property HasValue As Boolean
'Usage
Dim instance As XmlNodeReader
Dim value As Boolean

value = instance.HasValue
public override bool HasValue { get; }
public:
virtual property bool HasValue {
    bool get () override;
}
/** @property */
public boolean get_HasValue ()
public override function get HasValue () : boolean

Eigenschaftenwert

true, wenn der Knoten, auf dem der Reader derzeit positioniert ist, einen Value besitzen darf, andernfalls false.

Hinweise

Hinweis

Die empfohlene Vorgehensweise für Microsoft .NET Framework, Version 2.0 besteht darin, XmlReader-Instanzen mithilfe der XmlReaderSettings-Klasse und der Create-Methode zu erstellen. Dies erlaubt es, alle Vorteile der neu in .NET Framework enthaltenen Features zu nutzen. Weitere Informationen finden Sie unter Erstellen von XML-Readern.

In der folgenden Tabelle sind Knotentypen aufgeführt, die einen zurückzugebenden Wert haben.

Knotentyp

Wert

Attribute

Der Wert des Attributs.

CDATA

Der Inhalt des CDATA-Abschnitts.

Comment

Der Inhalt des Kommentars.

DocumentType

Die interne Teilmenge.

ProcessingInstruction

Der gesamte Inhalt mit Ausnahme des Ziels.

SignificantWhitespace

Der Leerraum zwischen Markup bei einem Modell für gemischten Inhalt.

Text

Der Inhalt des Textknotens.

Whitespace

Der Leerraum zwischen Markup.

XmlDeclaration

Der Inhalt der Deklaration.

Beispiel

Im folgenden Beispiel wird der Wert jedes Knotens angezeigt, der einen Wert aufweisen darf.

Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    Public Shared Sub Main()
        Dim reader As XmlNodeReader = Nothing
        
        Try
            'Create and load an XmlDocument.
            Dim doc As New XmlDocument()
            doc.LoadXml("<?xml version='1.0' ?>" & _
                        "<!DOCTYPE book [<!ENTITY h 'hardcover'>]>" & _
                        "<book>" & _
                        "<title>Pride And Prejudice</title>" & _
                        "<misc>&h;</misc>" & _
                        "</book>")
            
            reader = New XmlNodeReader(doc)
            
            'Parse the file and display each node.
            While reader.Read()
                If reader.HasValue Then
                    Console.WriteLine("({0})  {1}={2}", reader.NodeType, reader.Name, reader.Value)
                Else
                    Console.WriteLine("({0}) {1}", reader.NodeType, reader.Name)
                End If
            End While
        
        Finally
            If Not (reader Is Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub 'Main ' End class
using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {
  
    XmlNodeReader reader = null;

    try {
               
        // Create and load an XmlDocument.
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<?xml version='1.0' ?>" +
                    "<!DOCTYPE book [<!ENTITY h 'hardcover'>]>" +
                    "<book>" +
                    "<title>Pride And Prejudice</title>" +
                    "<misc>&h;</misc>" +
                    "</book>");

        reader = new XmlNodeReader(doc);

        // Parse the file and display each node.
        while (reader.Read()) {
           if (reader.HasValue)
             Console.WriteLine("({0})  {1}={2}", reader.NodeType, reader.Name, reader.Value);
           else
             Console.WriteLine("({0}) {1}", reader.NodeType, reader.Name);
         }           
     }

     finally {
       if (reader!=null)
         reader.Close();
     }
  }
} // End class
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlNodeReader^ reader = nullptr;
   try
   {
      
      // Create and load an XmlDocument.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<?xml version='1.0' ?>"
      "<!DOCTYPE book [<!ENTITY h 'hardcover'>]>"
      "<book>"
      "<title>Pride And Prejudice</title>"
      "<misc>&h;</misc>"
      "</book>" );
      reader = gcnew XmlNodeReader( doc );
      
      // Parse the file and display each node.
      while ( reader->Read() )
      {
         if ( reader->HasValue )
                  Console::WriteLine( "({0})  {1}={2}", reader->NodeType, reader->Name, reader->Value );
         else
                  Console::WriteLine( "({0}) {1}", reader->NodeType, reader->Name );
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}
import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlNodeReader reader = null;
        try {
            // Create and load an XmlDocument.
            XmlDocument doc = new XmlDocument();
            doc.LoadXml("<?xml version='1.0' ?>"
                + "<!DOCTYPE book [<!ENTITY h 'hardcover'>]>"
                + "<book>"
                + "<title>Pride And Prejudice</title>"
                + "<misc>&h;</misc>"
                + "</book>");

            reader = new XmlNodeReader(doc);

            // Parse the file and display each node.
            while (reader.Read()) {
                if (reader.get_HasValue()) {
                    Console.WriteLine("({0})  {1}={2}", reader.get_NodeType(), 
                        reader.get_Name(), reader.get_Value());
                }
                else {
                    Console.WriteLine("({0}) {1}", reader.get_NodeType(), 
                        reader.get_Name());
                }
            }
        } 
        finally {
            if (reader != null) {
                reader.Close();
            }
        }
    } //main
} //End class Sample

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

XmlNodeReader-Klasse
XmlNodeReader-Member
System.Xml-Namespace

Weitere Ressourcen

Lesen von XML mit dem "XmlReader"