Freigeben über


SecurityElement.Escape-Methode

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

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function Escape ( _
    str As String _
) As String
'Usage
Dim str As String
Dim returnValue As String

returnValue = SecurityElement.Escape(str)
public static string Escape (
    string str
)
public:
static String^ Escape (
    String^ str
)
public static String Escape (
    String str
)
public static function Escape (
    str : String
) : String

Parameter

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

Rückgabewert

Die Eingabezeichenfolge mit den ersetzten ungültigen Zeichen.

Hinweise

Ersetzen Sie ungültige Zeichen in einer Zeichenfolge mithilfe dieser Methode, bevor Sie die Zeichenfolge in einem SecurityElement verwenden. Wenn ungültige Zeichen in einer SecurityElement-Klasse verwendet werden, ohne in Escapezeichen umgewandelt worden zu sein, wird eine ArgumentException ausgelöst.

Die folgende Tabelle enthält die ungültigen XML-Zeichen und ihre in Escapezeichen umgewandelten Äquivalente.

Ungültige XML-Zeichen

Ersetzt durch

"<"

"&lt;"

">"

"&gt;"

"\""

"&quot;"

"\'"

"&apos;"

"&"

"&amp;"

Beispiel

Im folgenden Code wird die Verwendung der Escape-Methode zum Ersetzen ungültiger XML-Zeichen durch ihre gültige XML-Entsprechung veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die SecurityElement-Klasse.

tagText = SecurityElement.Escape(tagText)
tagText = SecurityElement.Escape(tagText);
tagText = SecurityElement::Escape( tagText );
tagText = SecurityElement.Escape(tagText);

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SecurityElement-Klasse
SecurityElement-Member
System.Security-Namespace