PersistChildrenAttribute.UsesCustomPersistence プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

PersistChildrenAttribute.UsesCustomPersistence プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

デザイン時に、サーバーコントロールが、入れ子になったコントロールをカスタマイズされた方法で保持するかどうかを示す値を取得します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 UsesCustomPersistence As Boolean

Visual Basic (使用法)

Dim instance As PersistChildrenAttribute
Dim value As Boolean

value = instance.UsesCustomPersistence

public bool UsesCustomPersistence { get;
 }

C++

public:
property bool UsesCustomPersistence {
    bool get ();
}

/** @property */
public boolean get_UsesCustomPersistence ()

JScript

public function get UsesCustomPersistence
 () : boolean

プロパティ値
入れ子になった内容をカスタマイズされた方法で保持する場合は true。それ以外の場合は false。既定値は false です。

解説

入れ子になった内容をカスタマイズされた方法で保持するように設定するには、usesCustomPersistence パラメータを受け取る PersistChildrenAttribute オーバーロードを使用します。

使用例

UsesCustomPersistence プロパティの値を取得する方法を次のコード例に示します。

このコード例は、PersistChildrenAttribute クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

<%@ Page Language="VB" %>
<%@ Register TagPrefix="AspSample" Assembly="Samples.AspNet.VB.Controls"
 Namespace="PersistChildrenSampleVB"
 %>


<!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)

    ' Create two new employees and add them to the custom control.
    Dim e1 As New Employee("Employee
 1", "Title 1", "Alias
 1")
    Dim e2 As New Employee("Employee
 2", "Title 2", "Alias
 2")
    CollectionPropertyControl1.Employees.Add(e1)
    CollectionPropertyControl1.Employees.Add(e2)

    ' Verify attribute values.
    Dim p As PersistChildrenAttribute = _
    Attribute.GetCustomAttribute(GetType(CollectionPropertyControl),
 _
    GetType(PersistChildrenAttribute))

    Dim sb As New StringBuilder()
    sb.Append("The Persist property is " & p.Persist.ToString()
 & "<br>")
    sb.Append("The UseCustomPersistence property is "
 & p.UsesCustomPersistence.ToString() & "<br>")
    sb.Append("The IsDefault method returns " &
 p.IsDefaultAttribute().ToString())
    Message.Text = sb.ToString()

  End Sub
  
</script>


<html  >
<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:CollectionPropertyControl>
    </div>
    </form>
</body>
</html>

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

<!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)
  {

    // Create two new employees and add them to the custom control.
    Employee e1 = new Employee("Employee 1", "Title
 1", "Alias 1");
    Employee e2 = new Employee("Employee 2", "Title
 2", "Alias 2");
    CollectionPropertyControl1.Employees.Add(e1);
    CollectionPropertyControl1.Employees.Add(e2);

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

    StringBuilder sb = new StringBuilder();
    sb.Append("The Persist property is " + p.Persist.ToString() + "<br>");
    sb.Append("The UseCustomPersistence property is " + p.UsesCustomPersistence.ToString()
 + "<br>");
    sb.Append("The IsDefault method returns " + p.IsDefaultAttribute().ToString());
    Message.Text = sb.ToString();
    
  }
</script>

<html  >
<head runat="server">
    <title>PersistChildrenAttribute</title>
</head>
<body>
    <form runat="server">
    <div>
      <asp:Label ID="Message"
                 runat="server"/>
      <AspSample:CollectionPropertyControl id="CollectionPropertyControl1"
 
                                           runat="server">
      </AspSample:CollectionPropertyControl>
    </div>
    </form>
</body>
</html>