XmlValidatingReader.ReadAttributeValue メソッド

2008-03-28

属性値を解析して、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 を加えた値です。一般エンティティ参照に出入りするとき、 Depth はそれぞれ 1 つずつ増減します。

たとえば、次の XML <test name="a &b; c"/> があるとします。

ここで、エンティティ b は、DTD で <!ENTITY b "123"> のように定義されます。

EntityHandling を ExpandCharEntities に設定すると、次の C# コードは、属性値を 2 つのテキストノードと 1 つのエンティティ参照ノードとして返します。

reader.MoveToAttribute("name");
 while (reader.ReadAttributeValue())
 {
 if (reader.NodeType == XmlNodeType.Text)
 {
 // at this point reader.Value == "a " or " c"
 }
 else if (reader.NodeType == XmlNodeType.EntityReference)
 {
 // at this point reader.Name == "b"
 reader.ResolveEntity();
 while (reader.ReadAttributeValue() &&
 reader.NodeType != XmlNodeType.EndEntity)
 {
 // reader.Value == "123"
 }
 }
   }

使用例

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

 
Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlValidatingReader = 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 and set it to not expand general entities. 
            reader = New XmlValidatingReader(xmlFrag, XmlNodeType.Element, context)
            reader.ValidationType = ValidationType.None
            reader.EntityHandling = EntityHandling.ExpandCharEntities
            
            'Read the misc attribute. Because EntityHandling is set to
            'ExpandCharEntities, 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()
  {
    XmlValidatingReader 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 and set it to not expand general entities. 
       reader = new XmlValidatingReader(xmlFrag, XmlNodeType.Element, context);
       reader.ValidationType = ValidationType.None;
       reader.EntityHandling = EntityHandling.ExpandCharEntities;
  
       //Read the misc attribute. Because EntityHandling is set to
       //ExpandCharEntities, 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 <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   XmlValidatingReader* 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 and set it to not expand general entities. 
      reader = new XmlValidatingReader(xmlFrag, XmlNodeType::Element, context);
      reader->ValidationType = ValidationType::None;
      reader->EntityHandling = EntityHandling::ExpandCharEntities;

      //Read the misc attribute. Because EntityHandling is set to
      //ExpandCharEntities, 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)
            //To expand the entity, call ResolveEntity.
            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 ファミリ

参照

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

次の方法で共有

XmlValidatingReader.ReadAttributeValue メソッド

戻り値

解説

使用例

必要条件

参照

その他のリソース