SecurityElement.Escape(String) Methode

Definition

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);
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

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;

Gilt für: