XmlTextReader.ReadAttributeValue メソッド

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

Overrides Public Function ReadAttributeValue() As Boolean
[C#]
public override bool ReadAttributeValue();
[C++]
public: bool ReadAttributeValue();
[JScript]
public override function ReadAttributeValue() : Boolean;

戻り値

返すノードがある場合は true 。

初めて呼び出すときにリーダーの位置が属性ノード上にない場合、またはすべての属性値が読み込まれている場合は、 false 。

misc="" などの空の属性は、値 String.Empty を持つ単一のノードと一緒に true を返します。

解説

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

一般エンティティは、単一の空の (Value が String.Empty) EntityReference ノードとして返されます。

使用例

[Visual Basic, C#, C++] テキスト ノードおよびエンティティ ノードを持つ属性を読み取る例を次に示します。

 
Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim reader as XmlTextReader = nothing

    try
       'Create the XML fragment to be parsed.
       Dim xmlFrag as string ="<book genre='novel' misc='sale-item &h; 1987'></book>"
 
       'Create the XmlParserContext.
       Dim context as XmlParserContext 
       Dim subset as string = "<!ENTITY h 'hardcover'>"
       context = new XmlParserContext(nothing, nothing, "book", nothing, nothing, subset, "", "", XmlSpace.None)
        
       'Create the reader.
       reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context)
  
       '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)
            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
        reader.Close()
      End if
      end try
  end sub
end class 

[C#] 
using System;
using System.IO;
using System.Xml;

public class Sample 
{
  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {
       //Create the XML fragment to be parsed.
       string xmlFrag ="<book genre='novel' misc='sale-item &h; 1987'></book>";
 
       //Create the XmlParserContext.
       XmlParserContext context;
       string subset = "<!ENTITY h 'hardcover'>";
       context = new XmlParserContext(null, null, "book", null, null, subset, "", "", XmlSpace.None);
        
       //Create the reader.
       reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context);
  
       //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)
            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 <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main() 
{
   XmlTextReader* reader = 0;

   __try
   {
      // Create the XML fragment to be parsed.
      String* xmlFrag =S"<book genre='novel' misc='sale-item &h; 1987'></book>";

      // Create the XmlParserContext.
      XmlParserContext * context;
      String* subset = S"<!ENTITY h 'hardcover'>";
      context = new XmlParserContext(0, 0, S"book", 0, 0, subset, S"", S"", XmlSpace::None);

      // Create the reader.
      reader = new XmlTextReader(xmlFrag, XmlNodeType::Element, context);

      // Read the misc attribute. The attribute is parsed
      // into multiple text and entity reference nodes.
      reader -> MoveToContent();
      reader -> MoveToAttribute(S"misc");
      while (reader -> ReadAttributeValue())
      {
         if (reader -> NodeType == XmlNodeType::EntityReference)
            Console::WriteLine(S" {0} {1}", __box(reader -> NodeType), reader -> Name);
         else
            Console::WriteLine(S" {0} {1}", __box(reader -> NodeType), reader -> Value);
      }
   }
   __finally
   {
      if (reader != 0)
         reader -> Close();
   }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

XmlTextReader クラス | XmlTextReader メンバ | System.Xml 名前空間