Encodes and decodes XML names, and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. When converting data types, the values returned are locale-independent.
Assembly: System.Xml (in System.Xml.dll)
Converts the name to a valid XML local name.
Converts the name to a valid XML name.
Verifies the name is valid according to the XML specification.
Determines whether the specified object is equal to the current object.(Inherited from Object.)
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
Serves as the default hash function. (Inherited from Object.)
Checks whether the passed-in character is a valid non-colon character type.
Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise null.
Checks if the passed-in character is a valid Start Name Character type.
Checks if the passed-in character is a valid XML whitespace character.
Checks if the passed-in character is a valid XML character.
Checks if the passed-in surrogate pair of characters is a valid XML character.
Returns a string that represents the current object.(Inherited from Object.)
Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.
Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. An NCName is a name that cannot contain a colon.
Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation
Returns the passed in string instance if all the characters in the string argument are valid public id characters.
Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.
Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.
Returns the passed-in string if all the characters and surrogate pair characters in the string argument are valid XML characters, otherwise an XmlException is thrown with information on the first invalid character encountered.
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.class is functionally equivalent to the
Element and attribute names or ID values are limited to a range of XML characters according to the W3C XML 1.0 recommendation. When names contain invalid characters, you can use the EncodeName and DecodeName 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 EncodeName method with the 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 followingmethods perform encoding and decoding.
Takes a name and returns the encoded name along with any invalid character that is replaced by an escape string. This method allows colons in any position, which means that the name may still be invalid according to the W3C Namespaces in XML 1.0 recommendation.
Takes a name and returns the encoded name.
Same as EncodeName except that it also encodes the colon character, guaranteeing that the name can be used as the LocalName part of a namespace-qualified name.
Reverses the transformation for all the encoding methods.
VerifyName 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.
VerifyNCName performs the same validation, but accepts non-qualified names.
Thecontains additional methods that validate tokens, white-space characters, public IDs, and other strings.
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 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.also provides methods that enable you to convert data from a string to a strongly typed data type. For example, the
Available since 4.5
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Available since 8.1
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.