XmlConvert.VerifyXmlChars(String) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlConvert.cs

如果字符串自变量中的所有字符和代理项对字符都是有效的 XML 字符，则返回传入的字符串；否则将引发 XmlException 并提供有关遇到的第一个无效字符的信息。

public:
 static System::String ^ VerifyXmlChars(System::String ^ content);

public static string VerifyXmlChars (string content);

static member VerifyXmlChars : string -> string

Public Shared Function VerifyXmlChars (content As String) As String

参数

content

String

包含要验证的字符的 String。

返回

String

如果字符串参数中的所有字符和代理项对字符都是有效的 XML 字符，则为传入字符串；否则将引发 XmlException 并提供有关遇到的第一个无效字符的信息。

示例

以下示例使用 VerifyXmlChars 用于检测 start 元素中的非法字符的方法。

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();
}

Dim writer3 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalChar As Char = ChrW(CInt("&hFFFE"))
Dim charsToVerify As String = "Test String "

Try
    ' Write the root element.
    writer3.WriteStartElement("root")

    ' Throw an exception for name that contains 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 e As XmlException

    Console.WriteLine(e.Message)
    writer3.Close()
End Try

注解

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

如果 参数为 null， ArgumentNullException 则会引发 。 如果任何字符不是有效的 xml 字符，则会引发 ， XmlException 其中包含遇到的第一个无效字符的信息。