AttributeCollection 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供对 ASP.NET 服务器控件元素的开始标记中声明的所有特性的对象模型访问。 此类不能被继承。
public ref class AttributeCollection sealed
public sealed class AttributeCollection
type AttributeCollection = class
Public NotInheritable Class AttributeCollection
- 继承
-
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 对象的当前实例是否等于指定的对象。 |
Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
GetHashCode() |
返回此实例的哈希代码。 |
GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
Remove(String) |
从服务器控件的 AttributeCollection 对象中移除一个特性。 |
Render(HtmlTextWriter) |
将特性集合写入该集合所属的控件的指定 HtmlTextWriter 输出流。 |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |