System.Xml.XmlConvert.VerifyXmlChars 方法

方法描述

如果字符串参数中的所有字符和代理项对字符都是有效的 XML 字符,则返回传入的字符串;否则返回 null。

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

public static string VerifyXmlChars(
	string content
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
content System-String 包含要验证的字符的 String。
返回值 System.String 如果字符串参数中的所有字符和代理项对字符都是有效的 XML 字符,则返回传入的字符串;否则返回 null。

提示和注释

不应返回除参数中传递的以外的其他值。 请参阅 XML 1.0 规范(第四版)生产 [2] Char 了解允许字符的详细信息。

如果该参数为 null,则引发 ArgumentNullException。 如果所有字符都不是有效的 xml 字符,则会引发 XmlException,且带有遇到第一个无效字符的信息。

System.Xml.XmlConvert.VerifyXmlChars 方法例子

下面的示例使用 VerifyXmlChars 方法检测开始元素中的非法字符。

XmlTextWriter writer3 = new XmlTextWriter("outFile.xml", null);
            char illegalChar = '\uFFFE';
            string charsToVerify = "Test String "; 

            try
            {
                // Write the root element.
                writer3.WriteStartElement("root");

                // Throw an exception due illegal character.
                writer3.WriteStartElement(
                    XmlConvert.VerifyXmlChars(charsToVerify + illegalChar));

                writer3.WriteString("ValueText");
                writer3.WriteEndElement();

                // Write the end tag for the root element.
                writer3.WriteEndElement();

                writer3.Close();

            }
            catch (XmlException e)
            {
                Console.WriteLine(e.Message);
                writer3.Close();
            }

异常

异常 异常描述

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.NET Framework 受以下版本支持:4 .NET Framework Client Profile 受以下版本支持:4 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。