Export (0) Print
Expand All

XmlValidatingReader.Name Property

Gets the qualified name of the current node.

Namespace:  System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public override string Name { get; }

Property Value

Type: System.String
The qualified name of the current node. For example, Name is bk:book for the element <bk:book>.
The name returned is dependent on the NodeType of the node. The following node types return the listed values. All other node types return an empty string.

Node Type

Name

Attribute

The name of the attribute.

DocumentType

The document type name.

Element

The tag name.

EntityReference

The name of the entity referenced.

ProcessingInstruction

The target of the processing instruction.

XmlDeclaration

The literal string xml.

NoteNote:

The XmlValidatingReader class is obsolete in .NET Framework version 2.0. You can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see Validating XML Data with XmlReader.

The following example reads an XML file and displays each of the nodes.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  private const String filename = "items.xml";

  public static void Main()
  {
     XmlTextReader txtreader = null;
     XmlValidatingReader reader = null;

     try
     {  
        //Load the reader with the data file and ignore all white space nodes.         
        txtreader = new XmlTextReader(filename);
        txtreader.WhitespaceHandling = WhitespaceHandling.None;

        //Implement the validating reader over the text reader. 
        reader = new XmlValidatingReader(txtreader);
        reader.ValidationType = ValidationType.None;

        //Parse the file and display each of the nodes. 
        while (reader.Read())
        {
           switch (reader.NodeType)
           {
             case XmlNodeType.Element:
               Console.Write("<{0}>", reader.Name);
               break;
             case XmlNodeType.Text:
               Console.Write(reader.Value);
               break;
             case XmlNodeType.CDATA:
               Console.Write("<![CDATA[{0}]]>", reader.Value);
               break;
             case XmlNodeType.ProcessingInstruction:
               Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
               break;
             case XmlNodeType.Comment:
               Console.Write("<!--{0}-->", reader.Value);
               break;
             case XmlNodeType.XmlDeclaration:
               Console.Write("<?xml version='1.0'?>");
               break;
             case XmlNodeType.Document:
               break;
             case XmlNodeType.DocumentType:
               Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
               break;
             case XmlNodeType.EntityReference:
               Console.Write(reader.Name);
               break;
             case XmlNodeType.EndElement:
               Console.Write("</{0}>", reader.Name);
               break;
           }       
        }           
     }

     finally
     {
        if (reader!=null)
          reader.Close();
     }
  }
} // End class
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;


int main()
{
   XmlTextReader* txtreader = 0;
   XmlValidatingReader* reader = 0;
   String* filename = S"items.xml";

   try
   {  
      //Load the reader with the data file and ignore all white space nodes.         
      txtreader = new XmlTextReader(filename);
      txtreader->WhitespaceHandling = WhitespaceHandling::None;

      //Implement the validating reader over the text reader. 
      reader = new XmlValidatingReader(txtreader);
      reader->ValidationType = ValidationType::None;

      //Parse the file and display each of the nodes.
      while (reader->Read())
      {
         switch (reader->NodeType)
         {
         case XmlNodeType::Element:
            Console::Write(S"<{0}>", reader->Name);
            break;
         case XmlNodeType::Text:
            Console::Write(reader->Value);
            break;
         case XmlNodeType::CDATA:
            Console::Write(S"<![CDATA[{0}]]>", reader->Value);
            break;
         case XmlNodeType::ProcessingInstruction:
            Console::Write(S"<?{0} {1}?>", reader->Name, reader->Value);
            break;
         case XmlNodeType::Comment:
            Console::Write(S"<!--{0}-->", reader->Value);
            break;
         case XmlNodeType::XmlDeclaration:
            Console::Write(S"<?xml version='1.0'?>");
            break;
         case XmlNodeType::Document:
            break;
         case XmlNodeType::DocumentType:
            Console::Write(S"<!DOCTYPE {0} [{1}]", reader->Name, reader->Value);
            break;
         case XmlNodeType::EntityReference:
            Console::Write(reader->Name);
            break;
         case XmlNodeType::EndElement:
            Console::Write(S"</{0}>", reader->Name);
            break;
         }       
      }           
   }

   __finally
   {
      if (reader!=0)
         reader->Close();
   }
}

The example uses the file, items.xml, as input.

<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
  <Item>Test with an entity: &number;</Item>
  <Item>test with a child element <more/> stuff</Item>
  <Item>test with a CDATA section <![CDATA[<456>]]> def</Item>
  <Item>Test with a char entity: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft