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 則會擲回 ，其中包含第一個無效字元所遇到的資訊。