XmlConvert.VerifyXmlChars(String) Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlConvert.cs

Retourne la chaîne transmise si tous les caractères et les caractères de paire de substitution dans l’argument de chaîne sont des caractères XML valides, sinon une XmlException exception est levée avec des informations sur le 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

String qui contient des caractères à vérifier.

Retours

String

Chaîne transmise si tous les caractères et caractères de paire de substitution dans l’argument de chaîne sont des caractères XML valides ; sinon, une XmlException valeur est levée avec des informations sur le 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émarrage.

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 production xml 1.0 (quatrième édition) [2]. Char

Si le paramètre a la valeur Null, une ArgumentNullException valeur est levée. Si l’un des caractères n’est pas valide, un XmlException caractère xml est levée avec des informations sur le premier caractère non valide rencontré.