XmlReader.IsEmptyElement プロパティ

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

XmlReader.IsEmptyElement プロパティ

派生クラスでオーバーライドされると、現在のノードが空の要素 (<MyElement/> など) かどうかを示す値を取得します。

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

Visual Basic (宣言)

Public MustOverride ReadOnly
 Property IsEmptyElement As Boolean

Visual Basic (使用法)

Dim instance As XmlReader
Dim value As Boolean

value = instance.IsEmptyElement

C#

public abstract bool IsEmptyElement { get;
 }

C++

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

J#

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

JScript

public abstract function get
 IsEmptyElement () : boolean

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

解説

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

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

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

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

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

使用例

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

Visual Basic

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() Then '
 Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>",
 reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content
 of the element.
    End If
  End If
End While

C#

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.
    }
  } 
} 

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

<book>
  <title>Pride And
 Prejudice</title>
  <price>19.95</price>
  <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

参照

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