AttributeCollection Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обеспечивает доступ ко всем атрибутам, объявленным в открывающем теге элемента управления сервера ASP.NET, используя объектную модель. Этот класс не наследуется.
public ref class AttributeCollection sealed
public sealed class AttributeCollection
type AttributeCollection = class
Public NotInheritable Class AttributeCollection
- Наследование
-
AttributeCollection
Примеры
В следующем примере создается новый AttributeCollection объект с именем myAttributeCollection
, а затем проверяется, была ли страница размещена обратно. В противном случае код добавляет два атрибута в коллекцию. Затем он получает количество атрибутов в коллекции и выполняет итерацию по коллекции, записывая ключ к каждому атрибуту на страницу. Если страница является обратной отправкой, код получает новое количество атрибутов и выполняет итерацию по коллекции, записывая ключ и значение каждого атрибута на страницу.
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 свойство, наследуемое всеми элементами управления веб-сервера. Атрибуты в коллекции атрибутов для элемента управления веб-сервера не обязательно соответствуют строго типизированным свойствам этого элемента управления.
Конструкторы
AttributeCollection(StateBag) |
Инициализирует новый экземпляр класса AttributeCollection. |
Свойства
Count |
Возвращает число атрибутов в объекте AttributeCollection. |
CssStyle |
Получает коллекцию стилей элемента управления сервера ASP.NET, которому принадлежит текущий объект AttributeCollection. |
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) |