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.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlTextWriter^ writer = gcnew XmlTextWriter( "out.xml", nullptr );
   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: