XmlReader.MoveToContent メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のノードがコンテンツ (空白以外のテキスト、 CDATA、 Element、 EndElement、 EntityReference、または EndEntity) ノードであるかどうかを確認します。 ノードがコンテンツ ノードでない場合、リーダーは次のコンテンツ ノードまたはファイルの末尾に進みます。
ProcessingInstruction、DocumentType、Comment、Whitespace、またはSignificantWhitespaceのノードをスキップします。
public:
virtual System::Xml::XmlNodeType MoveToContent();
public virtual System.Xml.XmlNodeType MoveToContent();
abstract member MoveToContent : unit -> System.Xml.XmlNodeType
override this.MoveToContent : unit -> System.Xml.XmlNodeType
Public Overridable Function MoveToContent () As XmlNodeType
返品
メソッドによって検出された現在のノードの NodeType 。リーダーが入力ストリームの末尾に達した場合に XmlNodeType.None 。
例外
入力ストリームで不適切な XML が検出されました。
前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。
例
これは、ランダムな XML マークアップを中断せずにスキップできるコードを記述する場合に便利です。 たとえば、次のコードがあるとします。
if (reader.MoveToContent() == XmlNodeType.Element && reader.Name == "price")
{
_price = reader.ReadString();
}
If reader.MoveToContent() = XmlNodeType.Element And reader.Name = "price" Then
_price = reader.ReadString()
End If
このコードでは、次の入力を中断することなく処理できます。
<price>123.4</price>
and
<?xml version="1.0"><!DOCTYPE price SYSTEM
"abc"><price>123.4</price>
and
<?xml version="1.0"><!DOCTYPE price SYSTEM "abc"
[<!ENTITY p
"123.4">]><price>&p;</price>
and
<!-- some test comment --><?processing
instruction?><price>123.4</price>
注釈
現在のノードが属性ノードの場合、このメソッドはリーダーを属性を所有する要素に戻します。
このメソッドの非同期バージョンについては、 MoveToContentAsyncを参照してください。