ISecurityEncodable.ToXml Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Creates an XML encoding of the security object and its current state.

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

Function ToXml As SecurityElement

Return Value

Type: System.Security.SecurityElement

An XML encoding of the security object, including any state information.

Custom code that extends security objects needs to implement the ToXml and FromXml methods to make the objects security-encodable.

The following code example demonstrates implementing the FromXml method. This code example is part of a larger example provided for the ISecurityEncodable class.

' Produce XML from the permission's fields.
Public Overrides Function ToXml() As SecurityElement
    ' These first three lines create an element with the required format.
    Dim e As New SecurityElement("IPermission")
    ' Replace the double quotation marks (“”) with single quotation marks (‘’)
    ' to remain XML compliant when the culture is not neutral.
    e.AddAttribute("class", [GetType]().AssemblyQualifiedName.Replace(ControlChars.Quote, "'"c))
    e.AddAttribute("version", "1")

    If Not m_specifiedAsUnrestricted Then
        e.AddAttribute("Flags", [Enum].Format(GetType(SoundPermissionState), m_flags, "G"))
        e.AddAttribute("Unrestricted", "true")
    End If
    Return e

End Function 'ToXml

.NET Framework
Available since 1.1
Return to top