AttributeCollection 類別

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

提供物件模型 (Object Model) 的存取權給 ASP.NET 伺服器控制項項目的開頭標記中宣告的所有屬性。 此類別無法獲得繼承。

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

繼承

Object

AttributeCollection

範例

下列範例會建立名為 myAttributeCollection 的新 AttributeCollection 物件，然後檢查頁面是否已回傳。 如果沒有，程式碼會將兩個屬性新增至集合。 然後，它會取得集合中的屬性數目，並逐一查看集合，並將索引鍵寫入頁面。 如果頁面是回傳，程式碼會取得新的屬性數目，並逐一查看集合，並將每個屬性的索引鍵和值寫入頁面。

AttributeCollection myAttributeCollection = null;

void Page_Load(object sender,EventArgs e)
{
   myAttributeCollection = new AttributeCollection(ViewState);
   Response.Write("<h3> AttributeCollection.AttributeCollection Sample </h3>");
   if (!IsPostBack)
   {  
      myAttributeCollection.Add("Color" ,"Color.Red");
      myAttributeCollection.Add("BackColor","Color.blue");
      Response.Write("Attribute Collection  count before PostBack = " + myAttributeCollection.Count);
      Response.Write("<br /><u><h4>Enumerating Attributes for CustomControl before PostBack</h4></u>");
      IEnumerator keys = myAttributeCollection.Keys.GetEnumerator();
      int i =1;
      String key;
      while (keys.MoveNext())
      {
         key = (String)keys.Current;
         Response.Write(i + ". "+key + "=" + myAttributeCollection[key]+"<br />");
         i++;
      }
   }
   else
   {
      Response.Write("Attribute Collection  count after PostBack = "+myAttributeCollection.Count);
      Response.Write("<br /><u><h4>Enumerating Attributes for CustomControl after PostBack</h4></u>");
      IEnumerator keys = myAttributeCollection.Keys.GetEnumerator();
      int i =1;
      String key;
      while (keys.MoveNext())
      {
         key = (String)keys.Current;
         Response.Write(i + ". "+key + "=" + myAttributeCollection[key]+"<br />");
         i++;
      }
   }
}

  Dim myAttributeCollection As AttributeCollection = Nothing 

  Sub Page_Load(sender As Object, e As EventArgs)
      myAttributeCollection = New AttributeCollection(ViewState)
      Response.Write("<h3> AttributeCollection.AttributeCollection Sample </h3>")
      If Not IsPostBack Then
         myAttributeCollection.Add("Color", "Color.Red")
         myAttributeCollection.Add("BackColor", "Color.blue")
         Response.Write("Attribute Collection count before PostBack = " & _
myAttributeCollection.Count.ToString())
         Response.Write("<br /><u><h4>Enumerating Attributes for " & _
                                 "CustomControl before PostBack</h4></u>")
         Dim keys As IEnumerator = myAttributeCollection.Keys.GetEnumerator()
         Dim i As Integer = 1
         Dim key As String
         While keys.MoveNext()
            key = CType(keys.Current, String)
            Response.Write(i.ToString() + ". " + key + "=" + myAttributeCollection(key) + "<br />")
            i += 1
         End While
      Else
         Response.Write("Attribute Collection  count after PostBack = " + _
                                    myAttributeCollection.Count.ToString())
         Response.Write("<br /><u><h4>Enumerating Attributes for " + _
                                 "CustomControl after PostBack</h4></u>")
         Dim keys As IEnumerator = myAttributeCollection.Keys.GetEnumerator()
         Dim i As Integer = 1
         Dim key As String
         While keys.MoveNext()
            key = CType(keys.Current, String)
            Response.Write(i.ToString() + ". " + key + "=" + myAttributeCollection(key) + "<br />")
            i += 1
         End While
      End If
   End Sub

備註

集合中的個別專案會傳回 String 物件做為其值。 如果集合中沒有屬性專案，集合會傳 null 回 。

HTML 伺服器控制項上的屬性可透過 Attributes 屬性以程式設計方式取得，由所有 HTML 伺服器控制項繼承。 ASP.NET 會將 HTML 伺服器控制項的屬性公開為這些控制項的屬性。

您可以透過 Attributes 屬性將屬性新增至網頁伺服器控制項，該屬性是由所有 Web 服務器控制項所繼承。 Web 服務器控制項之屬性集合中的屬性不一定對應至該控制項的強型別屬性。

建構函式

AttributeCollection(StateBag)

初始化 AttributeCollection 類別的新執行個體。

屬性

Count	取得 AttributeCollection 物件中的屬性數目。
CssStyle	取得目前 AttributeCollection 物件所屬的 ASP.NET 伺服器控制項樣式的集合。
Item[String]	取得或設定伺服器控制項的指定屬性值。
Keys	取得伺服器控制項的 AttributeCollection 物件中的所有屬性的索引鍵集合。

方法

Add(String, String)	將屬性加入至伺服器控制項的 AttributeCollection 物件。
AddAttributes(HtmlTextWriter)	將屬性從 AttributeCollection 類別加入負責將屬性當做標記呈現的 HtmlTextWriter 物件。
Clear()	從伺服器控制項的 AttributeCollection 物件中移除所有屬性。
Equals(Object)	判斷 AttributeCollection 物件目前的執行個體是否等於指定的物件。
GetHashCode()	傳回這個執行個體的雜湊碼。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(String)	從伺服器控制項的 AttributeCollection 物件移除屬性。
Render(HtmlTextWriter)	將屬性集合寫入為集合所屬控制項所指定的 HtmlTextWriter 輸出資料流。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• Attributes
• Attributes