ParseChildrenAttribute.DefaultProperty プロパティ

定義

サーバー コントロールの既定のプロパティを取得または設定します。このサーバー コントロールには、要素を解析した結果が格納されます。Gets or sets the default property for the server control into which the elements are parsed.

public:
 property System::String ^ DefaultProperty { System::String ^ get(); void set(System::String ^ value); };
public string DefaultProperty { get; set; }
member this.DefaultProperty : string with get, set
Public Property DefaultProperty As String

プロパティ値

要素を解析した結果が格納されるサーバー コントロールの既定のコレクション プロパティの名前。The name of the default collection property of the server control into which the elements are parsed.

例外

childrenAsPropertiesfalse に設定された、現在の ParseChildrenAttribute が呼び出されました。The current ParseChildrenAttribute was invoked with childrenAsProperties set to false.

次のコード例は、プロパティに対しDefaultPropertyてクエリを実行する方法を示しています。The following code example demonstrates how to query the DefaultProperty property. このコード例でCollectionPropertyControl使用Employeeされるおよびクラスの定義についてはParseChildrenAttribute、「」を参照してください。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>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="AspSample" Assembly="Samples.AspNet.VB.Controls" Namespace="Samples.AspNet.VB.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 Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' Verify attribute values.
    Dim p As ParseChildrenAttribute = _
    Attribute.GetCustomAttribute(GetType(CollectionPropertyControl), _
    GetType(ParseChildrenAttribute))

    Dim sb As 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()

  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>PersistChildrenAttribute</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>

注釈

プロパティは、文字列がParseChildrenAttributeコンストラクターに渡された場合にのみ使用されます。 DefaultPropertyThe DefaultProperty property is used only if a string is passed to the ParseChildrenAttribute constructor. クラスが作成されると、 DefaultPropertyプロパティは、解析対象のサーバーコントロールの既定のプロパティを定義します。 ParseChildrenAttributeWhen the ParseChildrenAttribute class is created, the DefaultProperty property defines the default property for the server control that is being parsed.

適用対象

こちらもご覧ください