XmlNodeReader.IsEmptyElement プロパティ

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

XmlNodeReader.IsEmptyElement プロパティ

現在のノードが空の要素 (<MyElement/> など) かどうかを示す値を取得します。

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

Visual Basic (宣言)

Public Overrides ReadOnly
 Property IsEmptyElement As Boolean

Visual Basic (使用法)

Dim instance As XmlNodeReader
Dim value As Boolean

value = instance.IsEmptyElement

C#

public override bool IsEmptyElement { get;
 }

C++

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

J#

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

JScript

public override function get
 IsEmptyElement () : boolean

プロパティ値
現在のノードが要素であり (NodeType が XmlNodeType.Element に等しい)、/> で終了している場合は true。それ以外の場合は false。

解説

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

このプロパティを使用すると、次の 2 つの違いを確認できます。

<item num="123"/> (IsEmptyElement が true)。

<item num="123"> (IsEmptyElement が false。ただし要素の内容は空)。

対応する EndElement ノードは、空の要素に対して生成されません。

使用例

各要素のテキストの内容を表示する例を次に示します。

Visual Basic

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlNodeReader = Nothing
        
        Try
            'Create and load the XML document.
            Dim doc As New
 XmlDocument()
            doc.LoadXml("<book>" & _
                        "<title>Pride And Prejudice</title>"
 & _
                        "<price>19.95</price>"
 & _
                        "<misc/>" & _
                        "</book>")
            
            'Load the XmlNodeReader 
            reader = New XmlNodeReader(doc)
            
            'Parse the XML and display the text content of each of the
 elements.
            While reader.Read()
                If reader.IsStartElement() Then
                    If reader.IsEmptyElement Then
                        Console.WriteLine("<{0}/>",
 reader.Name)
                    Else
                        Console.Write("<{0}> ",
 reader.Name)
                        reader.Read() 'Read the start tag.
                        If (reader.IsStartElement())  'Handle
 nested elements.
                          Console.WriteLine()
                          Console.Write("<{0}>",
 reader.Name)
                        End If
                        Console.WriteLine(reader.ReadString()) 'Read
 the text content of the element.
                    End If
                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()
  {
    XmlNodeReader reader = null;

    try
    {
       //Create and load the XML document.
       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<book>" +
                   "<title>Pride And Prejudice</title>" +
                   "<price>19.95</price>" +
                   "<misc/>" +
                   "</book>"); 

       //Load the XmlNodeReader 
       reader = new XmlNodeReader(doc);
  
       //Parse the XML and display the text content of each of the elements.
       while (reader.Read()){
         if (reader.IsStartElement()){
           if (reader.IsEmptyElement)
              Console.WriteLine("<{0}/>", reader.Name);
           else{
               Console.Write("<{0}> ", reader.Name);
               reader.Read(); //Read the start tag.
               if (reader.IsStartElement())  //Handle
 nested elements.
                   Console.Write("\r\n<{0}>", reader.Name);
               Console.WriteLine(reader.ReadString());  //Read the text
 content of the element.
           }
         }
       } 
       
     } 

     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()
{
   XmlNodeReader^ reader = nullptr;
   try
   {
      
      //Create and load the XML document.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<book>"
      "<title>Pride And Prejudice</title>"
      "<price>19.95</price>"
      "<misc/>"
      "</book>" );
      
      //Load the XmlNodeReader 
      reader = gcnew XmlNodeReader( doc );
      
      //Parse the XML and display the text content of each of the elements.
      while ( reader->Read() )
      {
         if ( reader->IsStartElement() )
         {
            if ( reader->IsEmptyElement )
                        Console::WriteLine( "<{0}/>", reader->Name
 );
            else
            {
               Console::Write( "<{0}> ", reader->Name );
               reader->Read(); //Read the start tag.
               if ( reader->IsStartElement() )
                              
               //Handle nested elements.
               Console::Write( "\r\n<{0}>", reader->Name );
               Console::WriteLine( reader->ReadString() ); //Read
 the text content of the element.
            }
         }
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

J#

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

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlNodeReader reader = null;
        try {
            //Create and load the XML document.
            XmlDocument doc = new XmlDocument();
            doc.LoadXml("<book>"
                + "<title>Pride And Prejudice</title>"
                + "<price>19.95</price>"
                + "<misc/>" 
                + "</book>");

            //Load the XmlNodeReader 
            reader = new XmlNodeReader(doc);

            // Parse the XML and display the text content of 
            // each of the elements.
            while (reader.Read()) {
                if (reader.IsStartElement()) {
                    if (reader.get_IsEmptyElement()) {
                        Console.WriteLine("<{0}/>", reader.get_Name());
                    }
                    else {
                        Console.Write("<{0}> ", reader.get_Name());
                        //Read the start tag.
                        reader.Read(); 
                        //Handle nested elements.
                        if (reader.IsStartElement()) { 
                            Console.Write("\r\n<{0}>", reader.get_Name());
                        }
                        //Read the text content of the element.
                        Console.WriteLine(reader.ReadString()); 
                    }
                }
            }
        }     
        finally {
            if (reader != null) {
                reader.Close();
         }
      }
    } //main
} // End class Sample

プラットフォーム

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

参照

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