AttributeCollection Класс

Определение

Обеспечивает доступ ко всем атрибутам, объявленным в открывающем теге элемента управления сервера ASP.NET, используя объектную модель.Provides object-model access to all attributes declared in the opening tag of an ASP.NET server control element. Этот класс не наследуется.This class cannot be inherited.

public ref class AttributeCollection sealed
public sealed class AttributeCollection
type AttributeCollection = class
Public NotInheritable Class AttributeCollection
Наследование
AttributeCollection

Примеры

В следующем примере создается новый AttributeCollection объект с именем myAttributeCollection, а затем проверяется, была ли страница отправлена обратно.The following example creates a new AttributeCollection object that is named myAttributeCollection, and then checks whether the page has been posted back. В противном случае код добавляет в коллекцию два атрибута.If it has not, the code adds two attributes to the collection. Затем он получает количество атрибутов в коллекции и выполняет итерацию по коллекции, записывая ключ к каждому атрибуту на странице.It then gets the number of attributes in the collection and iterates through the collection, writing the key to each attribute to the page. Если страница является обратной, код получает новое число атрибутов и выполняет итерацию по коллекции, записывая ключ и значение каждого атрибута на страницу.If the page is a postback, the code gets the new number of attributes and iterates through the collection, writing the key and value of each attribute to the page.

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 объект в качестве значения.Individual items in the collection return a String object as their value. Если в коллекции нет элементов атрибутов, коллекция возвращает null.If there are no attribute items in the collection, the collection returns null.

Атрибуты в серверном элементе управления HTML программно доступны через Attributes свойство, которое наследуется всеми серверными элементами управления HTML.Attributes on an HTML server control are programmatically available through the Attributes property, which is inherited by all HTML server controls. ASP.NET предоставляет атрибуты серверных элементов управления HTML как свойства этих элементов управления.ASP.NET exposes attributes of HTML server controls as properties of those controls.

Добавить атрибуты в серверный веб-элемент управления можно с Attributes помощью свойства, которое наследуется всеми серверными веб-элементами управления.You can add attributes to a Web server control through the Attributes property, which is inherited by all Web server controls. Атрибуты в коллекции Attributes для серверного веб-элемента управления не обязательно соответствуют строго типизированным свойствам элемента управления.The attributes in the attributes collection for a Web server control do not necessarily correspond to the control's strongly typed properties for that control.

Конструкторы

AttributeCollection(StateBag)

Инициализирует новый экземпляр класса AttributeCollection.Initializes a new instance of the AttributeCollection class.

Свойства

Count

Возвращает число атрибутов в объекте AttributeCollection.Gets the number of attributes in the AttributeCollection object.

CssStyle

Получает коллекцию стилей элемента управления сервера ASP.NET, которому принадлежит текущий объект AttributeCollection.Gets a collection of styles for the ASP.NET server control to which the current AttributeCollection object belongs.

Item[String]

Возвращает или устанавливает значение указанного атрибута серверного элемента управления.Gets or sets a specified attribute value for a server control.

Keys

Возвращает коллекцию ключей всей атрибутов в объекте AttributeCollection серверного элемента управления.Gets a collection of keys to all attributes in the server control's AttributeCollection object.

Методы

Add(String, String)

Добавляет атрибут к объекту AttributeCollection серверного элемента управления.Adds an attribute to a server control's AttributeCollection object.

AddAttributes(HtmlTextWriter)

Добавляет атрибуты из класса AttributeCollection к объекту HtmlTextWriter, ответственному за отрисовку таких атрибутов, как разметка.Adds attributes from the AttributeCollection class to the HtmlTextWriter object that is responsible for rendering the attributes as markup.

Clear()

Удаляет все атрибуты объекта серверного элемента управления AttributeCollection.Removes all attributes from a server control's AttributeCollection object.

Equals(Object)

Определяет равенство текущего экземпляра объекта AttributeCollection с указанным объектом.Determines whether the current instance of the AttributeCollection object is equal to the specified object.

GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Remove(String)

Удаляет атрибут объекта AttributeCollection серверного элемента управления.Removes an attribute from a server control's AttributeCollection object.

Render(HtmlTextWriter)

Записывает коллекцию атрибутов в указанный выходной поток HtmlTextWriter для элемента управления, которому принадлежит коллекция.Writes the collection of attributes to the specified HtmlTextWriter output stream for the control to which the collection belongs.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно