This documentation is archived and is not being maintained.

CodeAccessPermission.ToXml Method

When overridden in a derived class, creates an XML encoding of the security object and its current state.

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

Public MustOverride Function ToXml As SecurityElement
Dim instance As CodeAccessPermission
Dim returnValue As SecurityElement

returnValue = instance.ToXml
public abstract SecurityElement ToXml ()
public abstract function ToXml () : SecurityElement

Return Value

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.

Notes to Inheritors You must override this method in a derived class.

The following code example shows an override of the ToXml method. This code example is part of a larger example provided for the CodeAccessPermission class.

Public Overrides Function ToXml() As SecurityElement
    ' Use the SecurityElement class to encode the permission to XML.
    Dim esd As New SecurityElement("IPermission")

    Dim name As String = GetType(NameIdPermission).AssemblyQualifiedName
    esd.AddAttribute("class", name)
    esd.AddAttribute("version", "1.0")

    ' The following code for unrestricted permission is only included as an example for
    ' permissions that allow the unrestricted state. It is of no value for this permission.
    If m_Unrestricted Then
        esd.AddAttribute("Unrestricted", True.ToString())
    End If
    If Not (m_Name Is Nothing) Then
        esd.AddAttribute("Name", m_Name)
    End If
    Return esd
End Function 'ToXml

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0