PersistChildrenAttribute Constructor (Boolean)
.NET Framework (current version)
Initializes a new instance of the PersistChildrenAttribute class using a Boolean value indicating whether to persist nested content as nested controls.
Assembly: System.Web (in System.Web.dll)
Parameters
- persist
-
Type:
System.Boolean
true to persist the nested content as nested controls; otherwise, false.
The following code example demonstrates how to apply the PersistChildrenAttribute attribute for a custom server control named CollectionPropertyControl.
This code example is part of a larger example provided for the PersistChildrenAttribute class.
// Use the PersistChildren attribute to set the Persist // property to false so that none of this class's // child controls will be persisted as controls. They will // be persisted only as child elements of this class. // If you set the PersistChildren attribute to true, or if you // do not include this attribute when you create a control, // the child controls will be persisted as controls. [PersistChildren(false)] [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)] public sealed class CollectionPropertyControl : Control { private String header; private ArrayList employees = new ArrayList(); public String Header { get { return header; } set { header = value; } } public ArrayList Employees { get { return employees; } } // Override the CreateChildControls method to // add child controls to the Employees property when this // custom control is requested from a page. protected override void CreateChildControls() { Label label = new Label(); label.Text = Header; label.BackColor = Color.Beige; label.ForeColor = Color.Red; Controls.Add(label); Controls.Add(new LiteralControl("<BR> <BR>")); Table table = new Table(); TableRow htr = new TableRow(); TableHeaderCell hcell1 = new TableHeaderCell(); hcell1.Text = "Name"; htr.Cells.Add(hcell1); TableHeaderCell hcell2 = new TableHeaderCell(); hcell2.Text = "Title"; htr.Cells.Add(hcell2); TableHeaderCell hcell3 = new TableHeaderCell(); hcell3.Text = "Alias"; htr.Cells.Add(hcell3); table.Rows.Add(htr); table.BorderWidth = 2; table.BackColor = Color.Beige; table.ForeColor = Color.Red; foreach (Employee employee in Employees) { TableRow tr = new TableRow(); TableCell cell1 = new TableCell(); cell1.Text = employee.Name; tr.Cells.Add(cell1); TableCell cell2 = new TableCell(); cell2.Text = employee.Title; tr.Cells.Add(cell2); TableCell cell3 = new TableCell(); cell3.Text = employee.Alias; tr.Cells.Add(cell3); table.Rows.Add(tr); } Controls.Add(table); } }
.NET Framework
Available since 1.1
Available since 1.1
Control
PersistChildrenAttribute Overload
PersistChildrenAttribute Class
System.Web.UI Namespace
Custom Control Development
Show: