The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
XmlConvert::VerifyName Method (String^)
.NET Framework (current version)
Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.
Assembly: System.Xml (in System.Xml.dll)
Parameters
- name
-
Type:
System::String^
The name to verify.
| 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
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
Show: