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) |