WebControl.Attributes WebControl.Attributes WebControl.Attributes WebControl.Attributes Property

Определение

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

public:
 property System::Web::UI::AttributeCollection ^ Attributes { System::Web::UI::AttributeCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.AttributeCollection Attributes { get; }
member this.Attributes : System.Web.UI.AttributeCollection
Public ReadOnly Property Attributes As AttributeCollection

Значение свойства

Примеры

В следующем примере показано, Attributes как свойство WebControl объекта можно использовать для выполнения команды JavaScript при TextBox потере фокуса элементом управления.The following example illustrates how the Attributes property of a WebControl can be used to run a JavaScript command when the TextBox control loses focus.

Примечание

В следующем примере кода используется модель кода с одним файлом, и она может работать неправильно, если копировать их непосредственно в файл кода программной части.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.For more information, see Script Exploits Overview.


<%@ Page Language="C#" AutoEventWireup="True" %>

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Attributes Property of a Web Control</title>
<script language="C#" runat="server">
 
        void Page_Load(Object sender, EventArgs e) {
           TextBox1.Attributes["onblur"]="javascript:alert('Hello! Focus lost from text box!!');";    
        }
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form id="form1" runat="server">
 
    <asp:TextBox id="TextBox1" columns="54" 
     Text="Click here and then tap out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

<%@ Page Language="VB" AutoEventWireup="True" %>

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Attributes Property of a Web Control</title>
<script language="VB" runat="server">
 
        Sub Page_Load(sender As Object, e As EventArgs)
            TextBox1.Attributes("onblur") = "javascript:alert('Hello! Focus lost from text box!!');"
        End Sub
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form id="form1" runat="server">
 
    <asp:TextBox id="TextBox1" columns="54" 
     Text="Click here and then tap out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

Комментарии

Attributes Коллекция содержит коллекцию всех атрибутов, объявленных в открывающем теге серверного веб-элемента управления.The Attributes collection contains a collection of all attributes declared in the opening tag of a Web server control. Это позволяет программно управлять атрибутами, связанными с серверным веб-элементом управления.This allows you to programmatically control the attributes associated with a Web server control. Можно добавить атрибуты в коллекцию или удалить атрибуты из коллекции.You can add attributes to the collection or remove attributes from the collection.

Примечание

Это свойство отображается со всеми атрибутами в коллекции в открывающем теге элемента управления, независимо от параметров браузера.This property is rendered with all attributes in the collection in the control's opening tag, regardless of the browser settings. Не все браузеры поддерживают каждый отображаемый атрибут.Not all browsers support every attribute that is rendered. Неподдерживаемые атрибуты обычно игнорируются браузером.The unsupported attributes are usually ignored by the browser.

Примечание

Скрипт на стороне клиента нельзя добавить в WebControl экземпляр Attributes с помощью коллекции.You cannot add client-side script to a WebControl instance using the Attributes collection. Чтобы добавить скрипт на стороне клиента, используйте ClientScript свойство Page элемента управления.To add client-side script, use the ClientScript property on the Page control.

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

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