XmlReader::Name Property
When overridden in a derived class, gets the qualified name of the current node.
Assembly: System.Xml (in System.Xml.dll)
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. |
| Exception | Condition |
|---|---|
| InvalidOperationException | An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.” |
The following example reads an XML file and displays each of the nodes.
The sample uses the items.xml file.
<?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: A</Item> <!-- Fourteen chars in this element.--> <Item>1234567890ABCD</Item> </Items>
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1