XmlTextReader.HasValue Propriedade

Definição

Obtém um valor que indica se o nó atual pode ter um Value diferente de String.Empty.Gets a value indicating whether the current node can have a Value other than String.Empty.

public:
 virtual property bool HasValue { bool get(); };
public override bool HasValue { get; }
member this.HasValue : bool
Public Overrides ReadOnly Property HasValue As Boolean

Valor da propriedade

Boolean

true se o nó em que o leitor está posicionado no momento puder ter um Value, caso contrário, false.true if the node on which the reader is currently positioned can have a Value; otherwise, false.

Exemplos

O exemplo a seguir exibe o valor para cada nó que pode ter um valor.The following example displays the value for every node that can have a value.

#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();
   }

}

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
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
End Class

O exemplo usa o arquivo, book1.xml , como entrada.The example uses the file, book1.xml, as input.


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

Comentários

Observação

A partir do .NET Framework 2,0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

A tabela a seguir lista os tipos de nós que têm um valor a ser retornado.The following table lists node types that have a value to return.

Tipo de nóNode type ValorValue
Attribute O valor do atributo.The value of the attribute.
CDATA O conteúdo da seção CDATA.The content of the CDATA section.
Comment O conteúdo do comentário.The content of the comment.
DocumentType O subconjunto interno.The internal subset.
ProcessingInstruction Todo o conteúdo, exceto o destino.The entire content, excluding the target.
SignificantWhitespace Espaço em branco entre marcação em um modelo de conteúdo misto.The white space between markup in a mixed content model.
Text O conteúdo do nó de texto.The content of the text node.
Whitespace Espaço em branco entre a marcação.The white space between markup.
XmlDeclaration O conteúdo da declaração.The content of the declaration.

Aplica-se a

Confira também