The System.Xml.XmlConvert class is functionally equivalent to the Convert class, but it supports XML standards. The type system is based on the XML Schema definition language (XSD) schema type, and the values returned are always locale-independent.

Encoding and decoding

Element and attribute names or ID values are limited to a range of XML characters according to the W3C tp://www.w3.org/TR/2006/REC-xml-20060816/. When names contain invalid characters, you can use the XmlConvert.EncodeName(string) and XmlConvert.DecodeName(string) methods in this class to translate them into valid XML names.

For example, if you want to use the column heading "Order Detail" in a database, the database allows the space between the two words. However, in XML, the space between "Order" and "Detail" is considered an invalid XML character. You have to convert it into an escaped hexadecimal encoding and decode it later.

You can use the XmlConvert.EncodeName(string) method with the System.Xml.XmlWriter class to ensure the names being written are valid XML names. The following C# code converts the name "Order Detail" into a valid XML name and writes the element <Order_0x0020_Detail>My order</Order_0x0020_Detail>.

 writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");

The following System.Xml.XmlConvert methods perform encoding and decoding.

Name validation

The System.Xml.XmlConvert class contains two methods that check the characters in an element or attribute name and verify that the name conforms to the rules set by the W3C tp://www.w3.org/TR/2006/REC-xml-20060816/:

• XmlConvert.VerifyName(string) checks the characters and verifies that the name is valid. The method returns the name if it's valid, and throws an exception if it isn't.

• XmlConvert.VerifyNCName(string) performs the same validation, but accepts non-qualified names.

The System.Xml.XmlConvert contains additional methods that validate tokens, white-space characters, public IDs, and other strings.

Data type conversion

System.Xml.XmlConvert also provides methods that enable you to convert data from a string to a strongly typed data type. For example, the erload:System.Xml.XmlConvert.ToDateTime method converts a string to its DateTime equivalent. This is useful because most methods in the XmlReader class return data as a string. After the data is read, it can be converted to the proper data type before being used. The erload:System.Xml.XmlConvert.ToString overloads provide the complementary operation by converting strongly typed data to strings. For example, this is useful when you want to add the data to text boxes on a webpage. Locale settings are not taken into account during data conversion. The data types are based on the XML Schema (XSD) data types.