SecurityElement.Escape(String) Methode

Definition

Namespace:

System.Security

Assembly:

System.Runtime.dll

Quelle:

SecurityElement.cs

Ersetzt ungültige XML-Zeichen in einer Zeichenfolge durch die gültigen XML-Äquivalente.

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

public static string? Escape (string? str);

static member Escape : string -> string

Public Shared Function Escape (str As String) As String

Parameter

str

String

Die Zeichenfolge, in der ungültige Zeichen in Escapezeichen umzuwandeln sind.

Gibt zurück

String

Die Eingabezeichenfolge mit den ersetzten ungültigen Zeichen.

Beispiele

Der folgende Code zeigt die Verwendung der Escape -Methode, um ungültige XML-Zeichen in einer Zeichenfolge durch ihre gültige XML-Entsprechung zu ersetzen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SecurityElement-Klasse bereitgestellt wird.

tagText = SecurityElement::Escape( tagText );

tagText = SecurityElement.Escape(tagText);

    tagText = SecurityElement.Escape(tagText)
End If

Hinweise

Verwenden Sie diese Methode, um ungültige Zeichen in einer Zeichenfolge zu ersetzen, bevor Sie die Zeichenfolge in einem SecurityElementverwenden. Wenn ungültige Zeichen in einem SecurityElement ohne Escape verwendet werden, wird ein ArgumentException ausgelöst.

In der folgenden Tabelle sind die ungültigen XML-Zeichen und ihre escapeden Entsprechungen aufgeführt.

Ungültiges XML-Zeichen	Ersetzt durch
<	&lt;
>	&gt;
"	&quot;
'	&apos;
&	&amp;