XmlReader.Skip メソッド

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

XmlReader.Skip メソッド

現在のノードの子をスキップします。

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

Visual Basic (宣言)

Public Overridable Sub Skip

Visual Basic (使用法)

Dim instance As XmlReader

instance.Skip

C#

public virtual void Skip ()

C++

public:
virtual void Skip ()

J#

public void Skip ()

JScript

public function Skip ()

解説

次の XML 入力では、リーダーを <a> ノードまたはその属性に配置した場合、Skip を呼び出すとリーダーが <b> ノードに配置されます。

リーダーが既にリーフ ノード (<x> ノードやテキスト ノード abc など) に配置されている場合、Skip の呼び出しは、Read の呼び出しと同じになります。

 <a name="bob" age="123">
  <x/>abc<y/>
 </a>
 <b>
 ...
 </b>

このメソッドは、整形式の XML かどうかをチェックします。

リーダーが XmlValidatingReader の場合、このメソッドは、スキップした内容も検証します。

XmlReader 実装は、Skip メソッドが外部エンティティを展開するかどうかを判断します。さまざまな型の XmlReader オブジェクトに対して外部エンティティが展開されるかどうかを次の表に示します。

XmlReader の TyType	外部エンティティを展開
XmlTextReader	いいえ。
テキスト データを読み取る Create メソッドで作成される XmlReader インスタンス。	いいえ。
バイナリ データを読み取る Create メソッドで作成される XmlReader インスタンス。	該当しない。
Create メソッドで作成されるスキーマ検証 XmlReader インスタンス。	はい。
XmlValidatingReader	はい。
XPathNavigator オブジェクトで返される XmlReader インスタンス。	該当しない。
XmlNodeReader	いいえ。
別の XmlReader インスタンスをラップする XmlReader インスタンス。	基になる XmlReader の実装に依存 (基になる XmlReader の Skip メソッドが呼び出される)。

使用例

2 番目の Book ノードから XML ファイルを解析する例を次に示します。

Visual Basic

Using reader As XmlReader = XmlReader.Create("2books.xml")

  ' Move the reader to the second book node.
  reader.MoveToContent()
  reader.ReadToDescendant("book")
  reader.Skip() 'Skip the first book.
  ' Parse the file starting with the second book node.
  Do
    Select Case reader.NodeType
      Case XmlNodeType.Element
        Console.Write("<{0}", reader.Name)
        While reader.MoveToNextAttribute()
            Console.Write(" {0}='{1}'", reader.Name, reader.Value)
        End While
        Console.Write(">")
      Case XmlNodeType.Text
        Console.Write(reader.Value)
      Case XmlNodeType.EndElement
        Console.Write("</{0}>", reader.Name)
    End Select
  Loop While reader.Read()

End Using

C#

using (XmlReader reader = XmlReader.Create("2books.xml"))
 {

  // Move the reader to the second book node.
  reader.MoveToContent(); 
  reader.ReadToDescendant("book");
  reader.Skip(); //Skip the first book.

  // Parse the file starting with the second book node.
  do {
     switch (reader.NodeType) {
        case XmlNodeType.Element:
           Console.Write("<{0}", reader.Name);
           while (reader.MoveToNextAttribute()) {
               Console.Write(" {0}='{1}'", reader.Name, reader.Value);
           }
           Console.Write(">");
           break;
        case XmlNodeType.Text:
           Console.Write(reader.Value);
           break;
        case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
     }       
  }  while (reader.Read());    

}

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

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's
 Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride
 And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

プラットフォーム

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 の読み取り