AttributeCollection 类

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

提供对 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 服务器控件的属性公开为这些控件的属性。

可以通过 属性向 Web 服务器控件 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