XmlNodeReader.ReadAttributeValue メソッド

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

XmlNodeReader.ReadAttributeValue メソッド

属性値を解析して、1 つ以上の text、EntityReference、EndEntity の各ノードに格納します。

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

Visual Basic (宣言)

Public Overrides Function
 ReadAttributeValue As Boolean

Visual Basic (使用法)

Dim instance As XmlNodeReader
Dim returnValue As Boolean

returnValue = instance.ReadAttributeValue

C#

public override bool ReadAttributeValue ()

C++

public:
virtual bool ReadAttributeValue () override

J#

public boolean ReadAttributeValue ()

JScript

public override function ReadAttributeValue
 () : boolean

戻り値
返すノードがある場合は true。 初めて呼び出すときにリーダーの位置が属性ノード上にない場合、またはすべての属性値が読み込まれている場合は、false。 misc="" などの空の属性は、値 String.Empty を持つ単一のノードと一緒に true を返します。

解説

メモ
Microsoft .NET Framework version 2.0 では、XmlReaderSettings クラスと Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、.NET Framework で導入されたすべての新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

MoveToAttribute を呼び出した後、このメソッドを使用して、属性値を構成するテキスト ノードまたはエンティティ参照ノードを読み取ります。属性値ノードの Depth は、属性ノードの深さに 1 を加えた値です。一般エンティティ参照に出入りするとき、それぞれ 1 つずつ増減します。

使用例

テキスト ノードおよびエンティティ参照ノードを持つ属性を読み取る例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlNodeReader = Nothing
        
        Try
            'Create and load an XML document.
            Dim doc As New
 XmlDocument()
            doc.LoadXml("<!DOCTYPE book [<!ENTITY h 'harcover'>]>"
 & _
                        "<book genre='novel' misc='sale-item
 &h; 1987'>" & _
                        "</book>")
            
            'Create the reader. 
            reader = New XmlNodeReader(doc)
            
            'Read the misc attribute. The attribute is parsed into multiple
 
            'text and entity reference nodes.
            reader.MoveToContent()
            reader.MoveToAttribute("misc")
            While reader.ReadAttributeValue()
                If reader.NodeType = XmlNodeType.EntityReference
 Then
                    'To expand the entity, call ResolveEntity.
                    Console.WriteLine("{0} {1}", reader.NodeType,
 reader.Name)
                Else
                    Console.WriteLine("{0} {1}", reader.NodeType,
 reader.Value)
                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()
  {
    XmlNodeReader reader = null;

    try
    {
       //Create and load an XML document.
       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<!DOCTYPE book [<!ENTITY h 'harcover'>]>"
 +
                   "<book genre='novel' misc='sale-item &h; 1987'>"
 +
                   "</book>");
        
       //Create the reader. 
       reader = new XmlNodeReader(doc);

       //Read the misc attribute. The attribute is parsed into multiple
 
       //text and entity reference nodes.
       reader.MoveToContent();
       reader.MoveToAttribute("misc");
       while (reader.ReadAttributeValue()){
          if (reader.NodeType==XmlNodeType.EntityReference)
            //To expand the entity, call ResolveEntity.
            Console.WriteLine("{0} {1}", reader.NodeType, reader.Name);
          else
             Console.WriteLine("{0} {1}", reader.NodeType, reader.Value);
        } 
     } 
     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()
{
   XmlNodeReader^ reader = nullptr;
   try
   {
      
      //Create and load an XML document.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<!DOCTYPE book [<!ENTITY h 'harcover'>]>"
      "<book genre='novel' misc='sale-item &h; 1987'>"
      "</book>" );
      
      //Create the reader. 
      reader = gcnew XmlNodeReader( doc );
      
      //Read the misc attribute. The attribute is parsed into multiple
 
      //text and entity reference nodes.
      reader->MoveToContent();
      reader->MoveToAttribute( "misc" );
      while ( reader->ReadAttributeValue() )
      {
         if ( reader->NodeType == XmlNodeType::EntityReference
 )
                  
         //To expand the entity, call ResolveEntity.
         Console::WriteLine( "{0} {1}", reader->NodeType, reader->Name
 );
         else
                  Console::WriteLine( "{0} {1}", reader->NodeType, reader->Value
 );
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

J#

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlNodeReader reader = null;
        try {
            //Create and load an XML document.
            XmlDocument doc = new XmlDocument();
            doc.LoadXml("<!DOCTYPE book [<!ENTITY h 'harcover'>]>"
                + "<book genre='novel' misc='sale-item &h; 1987'>"
                + "</book>");

            //Create the reader. 
            reader = new XmlNodeReader(doc);

            //Read the misc attribute. The attribute is parsed into multiple
 
            //text and entity reference nodes.
            reader.MoveToContent();
            reader.MoveToAttribute("misc");
            while (reader.ReadAttributeValue()) {
                if (reader.get_NodeType().Equals(XmlNodeType.EntityReference))
 {
                    //To expand the entity, call ResolveEntity.
                    Console.WriteLine("{0} {1}", reader.get_NodeType(),
 
                        reader.get_Name());
                }
                else {
                    Console.WriteLine("{0} {1}", reader.get_NodeType(),
 
                        reader.get_Value());
                }
            }
        }
        finally {
            if (reader != null) {
                reader.Close();
            }
        }
    } //main
} // End class Sample

プラットフォーム

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

参照

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