WebControl.Attributes Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.
public:
property System::Web::UI::AttributeCollection ^ Attributes { System::Web::UI::AttributeCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Web.UI.AttributeCollection Attributes { get; }[<System.ComponentModel.Browsable(false)>]
member this.Attributes : System.Web.UI.AttributeCollectionPublic ReadOnly Property Attributes As AttributeCollectionValor da propriedade
Um AttributeCollection de pares de nome e valor.
- Atributos
Exemplos
O exemplo a seguir ilustra como a Attributes propriedade de um WebControl pode ser usada para executar um comando JavaScript quando o controle perde o TextBox foco.
Observação
O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se for copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado em um arquivo de texto vazio que tenha uma extensão .aspx. Para obter mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Modelo de Código de Página.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.
<%@ 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>
Comentários
A Attributes coleção contém uma coleção de todos os atributos declarados na marca de abertura de um controle de servidor Web. Isso permite controlar programaticamente os atributos associados a um controle de servidor Web. Você pode adicionar atributos à coleção ou remover atributos da coleção.
Observação
Essa propriedade é renderizada com todos os atributos na coleção na marca de abertura do controle, independentemente das configurações do navegador. Nem todos os navegadores dão suporte a todos os atributos renderizados. Os atributos sem suporte geralmente são ignorados pelo navegador.
Observação
Não é possível adicionar script do lado do cliente a uma WebControl instância usando a Attributes coleção. Para adicionar o script do lado do cliente, use a ClientScript propriedade no Page controle.