Partager via


XmlConvert.VerifyXmlChars(String) Méthode

Définition

Retourne les caractères de la chaîne passée si tous les caractères et caractères de la paire de substitution de l'argument de chaîne sont des caractères XML valides, sinon une exception XmlException est levée avec des informations relatives au premier caractère non valide rencontré.

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

Paramètres

content
String

Chaîne String qui contient les caractères à vérifier.

Retours

String

Caractères de la chaîne passée si tous les caractères et caractères de la paire de substitution de l’argument de chaîne sont des caractères XML valides, sinon une exception XmlException est levée avec des informations relatives au premier caractère non valide rencontré.

Exemples

L’exemple suivant utilise la VerifyXmlChars méthode utilisée pour détecter un caractère illégal dans l’élément de début.

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

Remarques

Aucune autre valeur que l’argument passé ne doit être retournée. Pour plus d’informations sur les caractères autorisés, consultez la spécification XML 1.0 (quatrième édition) production [2]. Char

Si le paramètre est null, une ArgumentNullException exception est levée. Si l’un des caractères ne sont pas des caractères xml valides, un XmlException caractère est levée avec des informations sur le premier caractère non valide rencontré.

S’applique à