System.Xml.XmlConvert 类

上一篇：System.Xml.XmlComment.WriteTo 方法下一篇：System.Xml.XmlConvert.DecodeName 方法

方法描述

对 XML 名称进行编码和解码并提供方法在公共语言类型库类型和 XML 架构定义语言 (XSD) 类型之间进行转换。当转换数据类型时，返回的值是独立于区域设置的。

语法定义(C# System.Xml.XmlConvert 类的用法)

public class XmlConvert

构造函数

构造函数名称	构造函数描述
XmlConvert	初始化 XmlConvert 类的新实例。

成员/方法

方法名称	方法描述
DecodeName	对名称进行解码。该方法完成 EncodeName 和 EncodeLocalName 方法的反向操作。
EncodeLocalName	将名称转换为有效的 XML 本地名称。
EncodeName	将名称转换为有效的 XML 名称。
EncodeNmToken	根据 XML 规范验证该名称是否有效。
Equals(Object)	确定指定的 Object 是否等于当前的 Object。（继承自 Object。）
Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
FromBinHexString	已过时。将 BinHex 编码的字符串转换为字节数组。
GetHashCode	用作特定类型的哈希函数。（继承自 Object。）
GetType	获取当前实例的 Type。（继承自 Object。）
IsNCNameChar	检查传入的字符是否是有效的非冒号字符类型。
IsPublicIdChar	如果参数中的字符是有效的公共 ID 字符，则返回传入的字符实例；否则返回 null。
IsStartNCNameChar	检查传入的字符是否是有效的起始名称字符类型。
IsWhitespaceChar	检查传入的字符是否是有效的 XML 空白字符。
IsXmlChar	检查传入的字符是否是有效的 XML 字符。
IsXmlSurrogatePair	检查传入的代理项字符对是否是有效的 XML 字符。
MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
ToBinHexString	已过时。将字节数组转换为 BinHex 编码的字符串。
ToBoolean	将 String 转换为等效的 Boolean。
ToByte	将 String 转换为等效的 Byte。
ToChar	将 String 转换为等效的 Char。
ToDateTime(String)	已过时。将 String 转换为等效的 DateTime。
ToDateTime(String, String)	将 String 转换为等效的 DateTime。
ToDateTime(String, String[])	将 String 转换为等效的 DateTime。
ToDateTime(String, XmlDateTimeSerializationMode)	使用指定的 XmlDateTimeSerializationMode 将 String 转换为 DateTime
ToDateTimeOffset(String)	将提供的 String 转换为等效的 DateTimeOffset。
ToDateTimeOffset(String, String)	将提供的 String 转换为等效的 DateTimeOffset。
ToDateTimeOffset(String, String[])	将提供的 String 转换为等效的 DateTimeOffset。
ToDecimal	将 String 转换为 Decimal 等效项。
ToDouble	将 String 转换为等效的 Double。
ToGuid	将 String 转换为等效的 Guid。
ToInt16	将 String 转换为等效的 Int16。
ToInt32	将 String 转换为等效的 Int32。
ToInt64	将 String 转换为等效的 Int64。
ToSByte	将 String 转换为等效的 SByte。
ToSingle	将 String 转换为等效的 Single。
ToString()	返回表示当前对象的字符串。（继承自 Object。）
ToString(Boolean)	将 Boolean 转换为 String。
ToString(Byte)	将 Byte 转换为 String。
ToString(Char)	将 Char 转换为 String。
ToString(DateTime)	已过时。将 DateTime 转换为 String。
ToString(DateTimeOffset)	将提供的 DateTimeOffset 转换为 String。
ToString(Decimal)	将 Decimal 转换为 String。
ToString(Double)	将 Double 转换为 String。
ToString(Guid)	将 Guid 转换为 String。
ToString(Int16)	将 Int16 转换为 String。
ToString(Int32)	将 Int32 转换为 String。
ToString(Int64)	将 Int64 转换为 String。
ToString(SByte)	将 SByte 转换为 String。
ToString(Single)	将 Single 转换为 String。
ToString(TimeSpan)	将 TimeSpan 转换为 String。
ToString(UInt16)	将 UInt16 转换为 String。
ToString(UInt32)	将 UInt32 转换为 String。
ToString(UInt64)	将 UInt64 转换为 String。
ToString(DateTime, String)	将 DateTime 转换为 String。
ToString(DateTime, XmlDateTimeSerializationMode)	使用指定的 XmlDateTimeSerializationMode 将 DateTime 转换为 String。
ToString(DateTimeOffset, String)	将提供的 DateTimeOffset 转换为指定格式的 String。
ToTimeSpan	将 String 转换为 TimeSpan 等效项。
ToUInt16	将 String 转换为等效的 UInt16。
ToUInt32	将 String 转换为等效的 UInt32。
ToUInt64	将 String 转换为等效的 UInt64。
VerifyName	根据 W3C 可扩展标记语言建议验证该名称是否是有效的名称。
VerifyNCName	根据 W3C 可扩展标记语言建议，验证名称是否是有效的 NCName。 NCName 是不能包含冒号的名称。
VerifyNMTOKEN	根据 W3C XML Schema Part2: Datatypes recommendation（W3C 的 XML 架构第 2 部分：数据类型建议），验证字符串是否为有效 NMTOKEN
VerifyPublicId	如果字符串参数中的所有字符都是有效的公共 ID 字符，则返回传入的字符串实例。
VerifyTOKEN	根据 W3C XML 架构第 2 部分“数据类型”建议，验证该字符串是否为有效标记。
VerifyWhitespace	如果字符串参数中的所有字符都是有效的空白字符，则返回传入的字符串实例。
VerifyXmlChars	如果字符串参数中的所有字符和代理项对字符都是有效的 XML 字符，则返回传入的字符串；否则返回 null。

提示和注释

根据“Extensible Markup Language (XML) 1.0 spec (Fourth Edition) recommendation”（可扩展标记语言 (XML) 1.0 规范（第四版）建议），元素和特性名或 ID 值局限于一系列 XML 字符。当名称包含无效字符时，EncodeName 和 DecodeName 方法用于将它们转换为有效的 XML 名称。

许多语言和应用程序（例如 Microsoft SQL Server 和 Microsoft Word）允许在它们的名称中使用 Unicode 字符，这些字符在 XML 名称中是无效的。例如，如果“Order Detail”是数据库中的一个列标题，则数据库允许在单词 Order 和 Detail 之间使用空格。但是，在 XML 中，Order 和 Detail 之间的空格将被视为无效的 XML 字符。这样，需要将该空格（一个无效的字符）转换为转义的十六进制编码，并可在以后对该编码进行解码。

可以将 EncodeName 方法和 XmlWriter 类一起使用来确保正在书写的名称是有效的 XML 名称。下面的 C# 代码将名称“Order Detail”转换为有效的 XML 名称并编写元素 My order。

复制

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

XmlConvert 还提供了使您能够在字符串和 .NET Framework 数据类型之间进行相互转换的方法。在数据转换过程中不考虑区域设置。数据类型基于 XML 架构 (XSD) 数据类型。

注意

在 .NET Framework 2.0 版中，XmlReader、XmlWriter 和 XPathNavigator 类包含可处理类型化数据的新方法。这些新方法为您处理字符串到 .NET Framework 数据类型的转换。