XmlTextReader.HasValue プロパティ

.NET Framework クラス ライブラリ リファレンス

XmlTextReader.HasValue プロパティ

現在のノードが String.Empty 以外の Value を保持できるかどうかを示す値を取得します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overrides ReadOnly
 Property HasValue As Boolean

Visual Basic (使用法)

Dim instance As XmlTextReader
Dim value As Boolean

value = instance.HasValue

C#

public override bool HasValue { get;
 }

C++

public:
virtual property bool HasValue {
    bool get () override;
}

J#

/** @property */
public boolean get_HasValue ()

JScript

public override function get
 HasValue () : boolean

プロパティ値
リーダーが現在配置されているノードが Value を持つことができる場合は true。それ以外の場合は false。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlReader.Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、このリリースで導入された新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

返す値を持つノード型の一覧を次の表に示します。

ノード型	値
Attribute	属性の値。
CDATA	CDATA セクションの内容。
Comment	コメントの内容。
DocumentType	内部サブセット。
ProcessingInstruction	ターゲットを含まない、全体の内容。
SignificantWhitespace	混合コンテンツ モデル内のマークアップ間の空白。
Text	テキスト ノードの内容。
Whitespace	マークアップ間の空白。
XmlDeclaration	宣言の内容。

使用例

値を持つことができるすべてのノードの値を表示する例を次に示します。

Visual Basic

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 

C#

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

C++

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

}

J#

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

この例では、入力として、book1.xml というファイルを使用しています。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlTextReader クラス
XmlTextReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り