System.Web.UI.ParseChildrenAttribute Class

Defines a metadata attribute that you can use when developing ASP.NET server controls. Use the System.Web.UI.ParseChildrenAttribute class to indicate how the page parser should treat content nested inside a server control tag declared on a page. This class cannot be inherited.

See Also: ParseChildrenAttribute Members

Syntax

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class ParseChildrenAttribute : Attribute

Remarks

The System.Web.UI.ParseChildrenAttribute class allows you to specify parsing logic for a custom server control by marking the server control with the System.Web.UI.ParseChildrenAttribute metadata attribute.

Marking your server control with the metadata attribute ParseChildren(true) instructs the parser to interpret the elements that are contained within the server control's tags as properties. In this scenario, the ParseChildrenAttribute.ChildrenAsProperties property is true.

Marking your server control with the metadata attribute ParseChildren(true,"<Default Property>") sets the ParseChildrenAttribute.DefaultProperty property to the name of the property that is passed into the attribute.

Marking your server control with the metadata attribute ParseChildren(false), the default value, instructs the parser to interpret the elements that are contained within the server control's tags as content that will be parsed with an associated System.Web.UI.ControlBuilder that is, as controls. In this scenario, the ParseChildrenAttribute.ChildrenAsProperties property is false.

For information about using attributes, see Extending Metadata Using Attributes.

Requirements

Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0