XmlConvert.VerifyWhitespace(String) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

如果字符串参数中的所有字符都是有效的空白字符，则返回传入的字符串实例。

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

public static string VerifyWhitespace (string content);

static member VerifyWhitespace : string -> string

Public Shared Function VerifyWhitespace (content As String) As String

参数

content

String

要验证的 String。

返回

String

如果字符串参数中的所有字符都是有效的空白字符，则为传入字符串实例；否则为 null。

示例

以下示例使用 VerifyWhitespace 该方法检测分配给 start 元素的值中是否存在无效字符。

XmlTextWriter writer5 = new XmlTextWriter("outFile.xml", null);
char illegalWhiteSpaceChar = '_';

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

    writer5.WriteStartElement("legalElement");
    // Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" +
        XmlConvert.VerifyWhitespace("\t" + illegalWhiteSpaceChar));

    // Write the end tag for the legal element.
    writer5.WriteEndElement();
    // Write the end tag for the root element.
    writer5.WriteEndElement();
    writer5.Close();
}
catch (Exception e)
{
    Console.WriteLine(e.Message);
    writer5.Close();
}

Dim writer5 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalWhiteSpaceChar As Char = "_"

Try
    ' Write the root element.
    writer5.WriteStartElement("root")
    writer5.WriteStartElement("legalElement")
    ' Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" + _
        XmlConvert.VerifyWhitespace("   " + illegalWhiteSpaceChar))

    writer5.WriteEndElement()

    ' Write the end tag for the root element.
    writer5.WriteEndElement()

    writer5.Close()

Catch e As XmlException
    Console.WriteLine(e.Message)
    writer5.Close()
End Try

注解

不应返回传入参数以外的其他值。 对于空格有效的字符在 XML 版本之间不会有所不同，因此不需要 xml 版本重载。

有关允许字符的详细信息，请参阅 XML 1.0 规范 (第四版) 生产 [3] S。

如果参数为 null，将引发一个 ArgumentNullException 参数。

如果任一字符不是有效的空格字符，则会引发一个 XmlException 包含第一个无效字符的信息。