XmlConvert.VerifyXmlChars(String) Methode

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

Parameters

Retouren

De doorgegeven tekenreeks als alle tekens en surrogaatpaartekens in het tekenreeksargument geldige XML-tekens zijn, anders wordt er een XmlException gegenereerd met informatie over het eerste ongeldige teken.

Voorbeelden

In het volgende voorbeeld wordt de methode gebruikt voor het VerifyXmlChars detecteren van een ongeldig teken in het beginelement.

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

Opmerkingen

Er moeten geen andere waarden worden geretourneerd dan het argument dat is doorgegeven. Zie de XML 1.0-specificatie (vierde editie) productie [2] Char voor meer informatie over de toegestane tekens.

Als de parameter null is, wordt er een ArgumentNullException gegenereerd. Als een van de tekens ongeldige XML-tekens is, wordt er een XmlException gegenereerd met informatie over het eerste ongeldige teken.