CodeAccessPermission::ToXml Method ()

.NET Framework (current version)

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)

Syntax

public:
virtual SecurityElement^ ToXml() abstract

Return Value

Type: System.Security::SecurityElement^

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

Implements

ISecurityEncodable::ToXml()

Remarks

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.

Examples

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.

C++

public:
   virtual SecurityElement^ ToXml() override
   {
      // Use the SecurityElement class to encode the permission to XML.
      SecurityElement^ esd = gcnew SecurityElement( "IPermission" );
      String^ name = NameIdPermission::typeid->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 )
      {
         esd->AddAttribute( "Unrestricted", true.ToString() );
      }

      if ( m_Name != nullptr )
      {
         esd->AddAttribute( "Name", m_Name );
      }

      return esd;
   }

Version Information

.NET Framework
Available since 1.1