DefaultProperty Property
Collapse the table of content
Expand the table of content

ParseChildrenAttribute.DefaultProperty Property

 

Gets or sets the default property for the server control into which the elements are parsed.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public string DefaultProperty { get; set; }

Property Value

Type: System.String

The name of the default collection property of the server control into which the elements are parsed.

Exception Condition
NotSupportedException

The current ParseChildrenAttribute was invoked with childrenAsProperties set to false.

The DefaultProperty property is used only if a string is passed to the ParseChildrenAttribute constructor. When the ParseChildrenAttribute class is created, the DefaultProperty property defines the default property for the server control that is being parsed.

The following code example demonstrates how to query the DefaultProperty property. For definitions of the CollectionPropertyControl and Employee classes that are used in this code example, see ParseChildrenAttribute.

<%@ Page Language="C#" Debug="true" %>
<%@ Register TagPrefix="AspSample" Assembly="Samples.AspNet.CS.Controls" Namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {

    // Verify attribute values.
    ParseChildrenAttribute p = 
      (ParseChildrenAttribute)Attribute.GetCustomAttribute(typeof(CollectionPropertyControl),
      typeof(ParseChildrenAttribute));

    StringBuilder sb = new StringBuilder();
    sb.Append("The DefaultProperty property is " + p.DefaultProperty.ToString() + "<br />");
    sb.Append("The ChildrenAsProperties property is " + p.ChildrenAsProperties.ToString() + "<br />");
    sb.Append("The IsDefaultAttribute method returns " + p.IsDefaultAttribute().ToString());
    Message.Text = sb.ToString();

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ParseChildrenAttribute Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label ID="Message"
                 runat="server"/>
      <AspSample:CollectionPropertyControl id="CollectionPropertyControl1" 
                                           runat="server">
        <AspSample:Employee Name="Employee 1" 
                            Title="Title 1" 
                            Alias="Alias 1" />
        <AspSample:Employee Name="Employee 2" 
                            Title="Title 2" 
                            Alias="Alias 2" />
      </AspSample:CollectionPropertyControl>    
    </div>
    </form>
</body>
</html>

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft