ISecurityEncodable::ToXml Method ()

 

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

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

SecurityElement^ ToXml()

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:
    virtual SecurityElement^ ToXml() override
    {
        // These first three lines create an element with the required format.
        SecurityElement^ element = gcnew SecurityElement("IPermission");
        // Replace the double quotation marks () 
        // with single quotation marks ()
        // to remain XML compliant when the culture is not neutral.
        element->AddAttribute("class", 
            GetType()->AssemblyQualifiedName->Replace('\"', '\''));
        element->AddAttribute("version", "1");

        if (!specifiedAsUnrestricted)
        {
            element->AddAttribute("Flags", 
                Enum::Format(SoundPermissionState::typeid, stateFlags, "G"));
        }   
        else
        {
            element->AddAttribute("Unrestricted", "true");
        }
        return element;
    }

.NET Framework
Available since 1.1
Return to top
Show: