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

Примеры

В следующем примере создается новый 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 экземпляр объекта указанному объекту.
GetHashCode()	Возвращает хэш-код для этого экземпляра.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Remove(String)	Удаляет атрибут из объекта серверного элемента управления AttributeCollection .
Render(HtmlTextWriter)	Записывает коллекцию атрибутов в указанный HtmlTextWriter выходной поток для элемента управления, к которому принадлежит коллекция.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Attributes
• Attributes