SecurityElement.Escape(String) Méthode

Définition

Espace de noms:

System.Security

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Remplace les caractères XML non valides dans une chaîne par leur équivalent XML valide.

public:
 static System::String ^ Escape(System::String ^ str);

public static string? Escape (string? str);

public static string Escape (string str);

static member Escape : string -> string

Public Shared Function Escape (str As String) As String

Paramètres

str

String

Chaîne dans laquelle ignorer les caractères non valides.

Retours

String

Chaîne d'entrée avec les caractères non valides remplacés.

Exemples

Le code suivant illustre l’utilisation de la Escape méthode pour remplacer les caractères XML non valides dans une chaîne par leur équivalent XML valide. Cet exemple de code fait partie d’un exemple plus complet fourni pour la SecurityElement classe.

tagText = SecurityElement::Escape( tagText );

tagText = SecurityElement.Escape(tagText);

    tagText = SecurityElement.Escape(tagText)
End If

Remarques

Utilisez cette méthode pour remplacer des caractères non valides dans une chaîne avant d’utiliser la chaîne dans un SecurityElement . Si des caractères non valides sont utilisés dans un SecurityElement sans être échappés, une ArgumentException exception est levée.

Le tableau suivant présente les caractères XML non valides et leurs équivalents échappés.

Caractère XML non valide	Remplacé par
<	&lt;
>	&gt;
"	&quot;
'	&apos;
&	&amp;