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
Not applicable.

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
End Class ' NameIdPermission 

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions