XmlValidatingReader.IsEmptyElement プロパティ

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

XmlValidatingReader.IsEmptyElement プロパティ

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

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

Visual Basic (宣言)

Public Overrides ReadOnly
 Property IsEmptyElement As Boolean

Visual Basic (使用法)

Dim instance As XmlValidatingReader
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 では、XmlValidatingReader クラスは使用されなくなりました。検証を実行する XmlReader のインスタンスは、XmlReaderSettings クラスおよび Create メソッドを使用して作成できます。詳細については、「XmlReader による XML データの検証」を参照してください。

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

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

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

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

スキーマ検証により既定の内容が要素に追加された場合でも、IsEmptyElement は true を返します。要素に既定値が含まれているかどうかは関係ありません。つまり IsEmptyElement は、ソース ドキュメント内の要素に終了要素タグがあるかどうかだけを報告します。

使用例

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

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
   
   Public Shared Sub Main()
      Dim txtreader As XmlTextReader = Nothing
      Dim reader As XmlValidatingReader = Nothing
      
      Try
         'Implement the readers.
         txtreader = New XmlTextReader("elems.xml")
         reader = New XmlValidatingReader(txtreader)
         
         '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()
  {
    XmlTextReader txtreader = null;
    XmlValidatingReader reader = null;

    try
    {
       //Implement the readers.
       txtreader = new XmlTextReader("elems.xml");
       reader = new XmlValidatingReader(txtreader);
  
       //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()
{
   XmlTextReader^ txtreader = nullptr;
   XmlValidatingReader^ reader = nullptr;
   try
   {
      
      //Implement the readers.
      txtreader = gcnew XmlTextReader( "elems.xml" );
      reader = gcnew XmlValidatingReader( txtreader );
      
      //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)
    {
        XmlTextReader txtReader = null;
        XmlValidatingReader reader = null;

        try {
            //Implement the readers.
            txtReader = new XmlTextReader("elems.xml");
            reader = new XmlValidatingReader(txtReader);

            //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());
                        reader.Read(); //Read the start tag.
                        if (reader.IsStartElement()) {
                         //Handle nested elements.
                            Console.Write("\r\n<{0}>", reader.get_Name());
                        }
                        Console.WriteLine(reader.ReadString()); 
                        //Read the text content of the element.
                    }
                }
            }
        }
        finally {
            if (reader != null) {
                reader.Close();
            }
      }
    } //main
} // End class Sample

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

<book>
  <title>Pride And
 Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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