VerifyName Method

XmlConvert.VerifyName Method (String)

 

Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.

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

public static string VerifyName(
	string name
)

Parameters

name
Type: System.String

The name to verify.

Return Value

Type: System.String

The name, if it is a valid XML name.

Exception Condition
XmlException

name is not a valid XML name.

ArgumentNullException

name is null or String.Empty.

This method can be used with the XmlWriter class in the following manner.

try{
  writer.WriteStartElement(XmlConvert.VerifyName("item"),"bar");
}
catch(Exception e)
{
  Console.WriteLine("error");
}

The following example uses the VerifyName method to write an element name.

using System;
using System.Xml;

public class Sample{

  public static void Main(){
     XmlTextWriter writer = new XmlTextWriter ("out.xml", null);
     string tag = "item name";

  try{

     // Write the root element.
     writer.WriteStartElement("root");

     writer.WriteStartElement(XmlConvert.VerifyName(tag));

     }
     catch (XmlException e){
        Console.WriteLine(e.Message);
        Console.WriteLine("Convert to a valid name...");
        writer.WriteStartElement(XmlConvert.EncodeName(tag));
     }

     writer.WriteString("hammer");
     writer.WriteEndElement();

     // Write the end tag for the root element.
     writer.WriteEndElement();

     writer.Close();

  }

}

Universal Windows Platform
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
Return to top
Show:
© 2016 Microsoft