XmlTextReader.HasValue-Eigenschaft

Ruft einen Wert ab, der angibt, ob der aktuelle Knoten einen anderen Value als String.Empty 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 XmlTextReader
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 die Version Microsoft .NET Framework, Version 2.0 besteht darin, mithilfe der System.Xml.XmlReader.Create-Methode XmlReader-Instanzen zu erstellen. So können Sie die neuen Features dieser Version in vollem Umfang 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 besitzen darf.

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing
        
        Try
            'Load the reader with the XML file.
            reader = New XmlTextReader("book1.xml")
            reader.WhitespaceHandling = WhitespaceHandling.None
            
            '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 'Sample 

using System;
using System.IO;
using System.Xml;

public class Sample
{

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

    try
    {           
        //Load the reader with the XML file.
        reader = new XmlTextReader("book1.xml");
        reader.WhitespaceHandling = WhitespaceHandling.None;

        //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()
{
   XmlTextReader^ reader = nullptr;
   try
   {
      
      //Load the reader with the XML file.
      reader = gcnew XmlTextReader( "book1.xml" );
      reader->WhitespaceHandling = WhitespaceHandling::None;
      
      //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)
    {
        XmlTextReader reader = null;

        try {
            //Load the reader with the XML file.
            reader = new XmlTextReader("book1.xml");
            reader.set_WhitespaceHandling(WhitespaceHandling.None);
            //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

Im Beispiel wird die Datei book1.xml als Eingabe verwendet.

<?xml version='1.0' ?>
<!DOCTYPE book [<!ENTITY h 'hardcover'>]>
<book>
  <title>Pride And Prejudice</title>
  <misc>&h;</misc>
</book>

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

XmlTextReader-Klasse
XmlTextReader-Member
System.Xml-Namespace

Weitere Ressourcen

Lesen von XML mit dem "XmlReader"