XmlTextReader.HasValue Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um valor que indica se o nó atual pode ter um Value diferente de 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
true
se o nó em que o leitor está posicionado no momento puder ter um Value
, caso contrário, false
.
O exemplo a seguir exibe o valor de cada nó que pode ter um valor.
#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.
<?xml version='1.0' ?>
<!DOCTYPE book [<!ENTITY h 'hardcover'>]>
<book>
<title>Pride And Prejudice</title>
<misc>&h;</misc>
</book>
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.
A tabela a seguir lista os tipos de nós que têm um valor a ser retornado.
Tipo de nó | Valor |
---|---|
Attribute |
O valor do atributo. |
CDATA |
O conteúdo da seção CDATA. |
Comment |
O conteúdo do comentário. |
DocumentType |
O subconjunto interno. |
ProcessingInstruction |
Todo o conteúdo, exceto o destino. |
SignificantWhitespace |
Espaço em branco entre marcação em um modelo de conteúdo misto. |
Text |
O conteúdo do nó de texto. |
Whitespace |
Espaço em branco entre a marcação. |
XmlDeclaration |
O conteúdo da declaração. |