SecurityElement.Escape Method
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Replaces invalid XML characters in a string with their valid XML equivalent.
Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)
Parameters
- str
- Type: System.String
The string within which to escape invalid characters.
Use this method to replace invalid characters in a string before using the string in a SecurityElement. If invalid characters are used in a SecurityElement without being escaped, an ArgumentException is thrown.
The following table shows the invalid XML characters and their escaped equivalents.
|
invalid XML Character |
Replaced With |
|---|---|
|
"<" |
"<" |
|
">" |
">" |
|
"\"" |
""" |
|
"\'" |
"'" |
|
"&" |
"&" |
The following code shows the use of the Escape method to replace invalid XML characters in a string with their valid XML equivalent. This code example is part of a larger example provided for the SecurityElement class.
Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.