XmlConvert.VerifyXmlChars(String) 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

Source:

XmlConvert.cs

如果字串引數中的所有字元及 Surrogate 字組字元都是有效的 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

如果字串引數中的所有字元及 Surrogate 字組字元都是有效的 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

備註

不應該傳回傳入引數以外的其他值。 如需允許字元的詳細資訊，請參閱XML 1.0 規格 (第四版) 生產環境 [2]。 Char

如果 參數為 null， ArgumentNullException 將會擲回 。 如果有任何字元不是有效的 xml 字元， XmlException 則會擲回 ，其中會擲回第一個無效字元的相關資訊。