System.Security.SecurityElement Class - .NET Framework MSDN Library

Namespace

Assembly

mscorlib.dll

Syntax


public sealed class SecurityElement

Remarks

The SecurityElement class is used to represent an XML element that can store security-related information. It can contain attributes, child elements, and text content. This class is particularly useful for managing security policies, permissions, and other security-related configurations.

Each SecurityElement object has a tag name, which is the name of the XML element. It can also have attributes, which are key-value pairs associated with the element. Additionally, it can contain child SecurityElement objects or text content.

This class provides methods for creating, parsing, and manipulating XML structures that are relevant to security. It is an important component for applications that need to manage security settings in a structured and programmatic way.

Properties

Name	Description
Attributes	Gets a dictionary of the attributes of the current `SecurityElement`.
Children	Gets a list of the child elements of the current `SecurityElement`.
Tag	Gets the tag name of the current `SecurityElement`.
Text	Gets or sets the text content of the current `SecurityElement`.

Methods

Name	Description
AddAttribute	Adds an attribute to the current `SecurityElement`.
AddChild	Adds a child element to the current `SecurityElement`.
Copy	Creates a deep copy of the current `SecurityElement`.
Equals	Determines whether the specified object is equal to the current object.
FromXml	Deserializes a `SecurityElement` from an XML string.
GetAttribute	Gets the value of the specified attribute.
GetHashCode	Serves as the default hash function.
GetType	Gets the type of the current instance.
Parse	Parses an XML string and returns a `SecurityElement`.
ToXml	Serializes the current `SecurityElement` to an XML string.
ToString	Returns a string that represents the current object.

Constructors

Name	Description
SecurityElement(string tag)	Initializes a new instance of the `SecurityElement` class with the specified tag.
SecurityElement(string tag, string text)	Initializes a new instance of the `SecurityElement` class with the specified tag and text content.

Example

The following example demonstrates how to create and manipulate a SecurityElement.

using System;
using System.Security;
using System.Collections;

public class Example
{
    public static void Main(string[] args)
    {
        // Create a root SecurityElement
        SecurityElement rootElement = new SecurityElement("Policy");

        // Add attributes
        rootElement.AddAttribute("version", "1.0");

        // Create a child element
        SecurityElement policyLevel = new SecurityElement("PolicyLevel");
        policyLevel.AddAttribute("name", "FullTrust");
        policyLevel.Text = "Full trust granted.";

        // Add the child element to the root
        rootElement.AddChild(policyLevel);

        // Create another child element with nested structure
        SecurityElement permissionSet = new SecurityElement("PermissionSet");
        permissionSet.AddAttribute("class", "System.Security.PermissionSet");
        permissionSet.AddAttribute("version", "1");

        SecurityElement securityPermission = new SecurityElement("IPermission");
        securityPermission.AddAttribute("class", "System.Security.Permissions.SecurityPermission");
        securityPermission.AddAttribute("version", "1");
        securityPermission.AddAttribute("Flags", "Execution");

        permissionSet.AddChild(securityPermission);
        rootElement.AddChild(permissionSet);

        // Convert to XML string
        string xmlOutput = rootElement.ToXml();
        Console.WriteLine("Generated XML:");
        Console.WriteLine(xmlOutput);

        // Parse XML string back into a SecurityElement
        SecurityElement parsedElement = SecurityElement.FromString(xmlOutput);

        // Access data from the parsed element
        Console.WriteLine("\nAccessing parsed data:");
        Console.WriteLine($"Root Tag: {parsedElement.Tag}");
        Console.WriteLine($"Root Version Attribute: {parsedElement.GetAttribute("version")}");

        // Iterate through children
        foreach (object child in parsedElement.Children)
        {
            if (child is SecurityElement seChild)
            {
                Console.WriteLine($"  Child Tag: {seChild.Tag}");
                Console.WriteLine($"  Child Attributes:");
                foreach (DictionaryEntry attr in seChild.Attributes)
                {
                    Console.WriteLine($"    {attr.Key} = {attr.Value}");
                }
                if (!string.IsNullOrEmpty(seChild.Text))
                {
                    Console.WriteLine($"  Child Text: {seChild.Text}");
                }
            }
        }
    }
}

Output:

Generated XML:
<Policy version="1.0"><PolicyLevel name="FullTrust">Full trust granted.</PolicyLevel><PermissionSet class="System.Security.PermissionSet" version="1"><IPermission class="System.Security.Permissions.SecurityPermission" version="1" Flags="Execution" /></PermissionSet></Policy>

Accessing parsed data:
Root Tag: Policy
Root Version Attribute: 1.0
  Child Tag: PolicyLevel
  Child Attributes:
    name = FullTrust
  Child Text: Full trust granted.
  Child Tag: PermissionSet
  Child Attributes:
    class = System.Security.PermissionSet
    version = 1
  Child Tag: IPermission
  Child Attributes:
    class = System.Security.Permissions.SecurityPermission
    version = 1
    Flags = Execution