NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

SecurityElement Class

The SecurityElement class is defined to represent the XML object model for encoding security objects. The design is intended to be a lightweight implementation of a simple XML object model for use within the security system, and not intended for use as a general XML object model.

Object
   SecurityElement

[Visual Basic]
Public Class SecurityElement
[C#]
public class SecurityElement
[C++]
public __gc class SecurityElement
[JScript]
public class SecurityElement

Remarks

The simple XML object model for an element consists of the following parts: ? tag is the element name as shown below ? text is a string contained between delimeters <TAG>... </TAG>? children are zero or more elements nested within <TAG>... </TAG> ? attributes are zero or more name/value attribute pairs

Elements with a NULL text string are represented in the <TAG> form, otherwise text is delimited by <TAG> ... </TAG> tokens. Both forms may or may not be combined with attributes, which are shown if present or omitted otherwise. Attributes that appear as <TAG name> instead of <TAG name="value"> are designated by the distinguished object SecurityElement.NoValue. The attribute name must be non-NULL and of one character or longer.

The tags, attributes, and text of elements are always case-sensitive. The XML form will contain quotations and escapes where necessary. String values that include characters that are invalid for use in tag/name/value/text will result in ArgumentException being raised. The above rules apply to all properties and methods. NOTE: for performance reasons character validity is only checked when the element is encoded into XML text form, and not on every possible set of a property or method. Static methods allow explicit checking where needed.

Requirements

Namespace: System.Security

Assembly: mscorlib.dll

See Also

SecurityElement Members | System.Security Namespace