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

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

• Attributes
• Attributes