See Also: SecurityElement Members

Thread Safety

All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.

Remarks

The simple XML object model for an element consists of the following parts:

• The tag is the element name.
• The attributes are zero or more name/value attribute pairs on the element.
• The children are zero or more elements nested within <tag> and </tag>.

An attribute name must be at least one character, and cannot be null . If element-based value representation is used, elements with a text string that is null are represented in the <tag/> form; otherwise, text is delimited by the <tag> and </tag> tokens. Both forms can be combined with attributes, which are shown if present.

The tags, attributes, and text are case-sensitive. The XML form contains quotation marks and escape sequences where necessary. String values that include characters invalid for use in XML result in a ArgumentException. These rules apply to all properties and methods.

Note:

This class is intended to be a lightweight implementation of a simple XML object model for use within the security system, and not for use as a general XML object model.

It is strongly suggested that properties of a security element are expressed as attributes, and property values are expressed as attribute values. Specifically, avoid nesting text within tags. For any <tag>text</tag> representation a representation of type <tag value="text"/> is usually available. Using attribute-based XML representations aids in readability.

For performance reasons, character validity is checked only when the element is encoded into XML form, and not on every set of a property or method call. Static methods allow explicit checking where needed.

Requirements

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0