XmlReader.IsStartElement

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

XmlReader.IsStartElement メソッド ()

MoveToContent を呼び出し、現在のコンテンツ ノードが開始タグまたは空の要素タグかどうかをテストします。

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

Visual Basic (宣言)

Public Overridable Function
 IsStartElement As Boolean

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As Boolean

returnValue = instance.IsStartElement

C#

public virtual bool IsStartElement ()

C++

public:
virtual bool IsStartElement ()

J#

public boolean IsStartElement ()

JScript

public function IsStartElement () : boolean

戻り値
MoveToContent が開始タグまたは空の要素タグを見つけた場合は true。XmlNodeType.Element 以外のノード型が見つかった場合は false。

例外

例外の種類	条件
XmlException	入力ストリームで、正しくない XML が検出されました。

解説

このメソッドは、リーダーがコンテンツ ノードに配置されるまで、空白、コメント、および処理命令をスキップします。その後、現在のノードが要素かどうかをテストします。

使用例

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

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 名前空間
MoveToContent
その他の技術情報
XmlReader による XML の読み取り
XmlReader による XML の読み取り

XmlReader.IsStartElement メソッド (String, String)

MoveToContent を呼び出し、現在のコンテンツ ノードが開始タグまたは空の要素タグかどうか、また、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致するかどうかをテストします。

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

Visual Basic (宣言)

Public Overridable Function
 IsStartElement ( _
    localname As String, _
    ns As String _
) As Boolean

Visual Basic (使用法)

Dim instance As XmlReader
Dim localname As String
Dim ns As String
Dim returnValue As Boolean

returnValue = instance.IsStartElement(localname, ns)

C#

public virtual bool IsStartElement (
    string localname,
    string ns
)

C++

public:
virtual bool IsStartElement (
    String^ localname, 
    String^ ns
)

J#

public boolean IsStartElement (
    String localname, 
    String ns
)

JScript

public function IsStartElement (
    localname : String, 
    ns : String
) : boolean

パラメータ

localname

見つかった要素の LocalName プロパティと一致する文字列。

ns

見つかった要素の NamespaceURI プロパティと一致する文字列。

戻り値
見つかったノードが要素の場合は true。XmlNodeType.Element 以外のノード型が見つかった場合、または要素の LocalName プロパティと NamespaceURI プロパティが指定した文字列と一致しない場合は false。

例外

例外の種類	条件
XmlException	入力ストリームで、正しくない XML が検出されました。

解説

このメソッドは、リーダーがコンテンツ ノードに配置されるまで、空白、コメント、および処理命令をスキップします。その後、現在のノードが要素かどうかをテストします。

プラットフォーム

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 名前空間
MoveToContent
その他の技術情報
XmlReader による XML の読み取り

XmlReader.IsStartElement メソッド

現在のコンテンツ ノードが開始タグかどうかをテストします。
オーバーロードの一覧

名前	説明
XmlReader.IsStartElement ()	MoveToContent を呼び出し、現在のコンテンツ ノードが開始タグまたは空の要素タグかどうかをテストします。 .NET Compact Framework によってサポートされています。
XmlReader.IsStartElement (String)	MoveToContent を呼び出し、現在のコンテンツ ノードが開始タグまたは空の要素タグかどうか、また、見つかった要素の Name プロパティが、指定した引数と一致するかどうかをテストします。 .NET Compact Framework によってサポートされています。
XmlReader.IsStartElement (String, String)	MoveToContent を呼び出し、現在のコンテンツ ノードが開始タグまたは空の要素タグかどうか、また、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致するかどうかをテストします。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
MoveToContent

その他の技術情報

XmlReader による XML の読み取り
XmlReader による XML の読み取り

XmlReader による XML の読み取り