Partilhar via

WebControl.AccessKey Propriedade

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web.

public:
 virtual property System::String ^ AccessKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string AccessKey { get; set; }
public virtual string AccessKey { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.AccessKey : string with get, set
member this.AccessKey : string with get, set
Public Overridable Property AccessKey As String

Valor da propriedade

String

A chave de acesso para navegação rápida no controle do servidor Web. O valor padrão é Empty, que indica que essa propriedade não está definida.

Atributos
BindableAttribute

Exceções

ArgumentOutOfRangeException

A chave de acesso especificada não é nem null, Empty nem uma única cadeia de caracteres.

Exemplos

O exemplo a seguir ilustra como definir e usar a AccessKey propriedade de um TextBox controle.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das 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>AccessKey Property of a Web Control</title>
</head>
 <body>
 
   <h3>AccessKey Property of a Web Control</h3>
 
 <form id="form1" runat="server">
 
   <asp:TextBox id="TextBox1" 
     AccessKey="Y" 
     Text="Press Alt-Y to get focus here" 
     Columns="45"
     runat="server"/>
 
   <br />
 
   <asp:TextBox id="TextBox2" 
     AccessKey="Z" 
     Text="Press Alt-Z to get focus here" 
     Columns="45"
     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>AccessKey Property of a Web Control</title>
</head>
 <body>
 
   <h3>AccessKey Property of a Web Control</h3>
 
 <form id="form1" runat="server">
 
   <asp:TextBox id="TextBox1" 
     AccessKey="Y" 
     Text="Press Alt-Y to get focus here" 
     Columns="45"
     runat="server"/>
 
   <br />
 
   <asp:TextBox id="TextBox2" 
     AccessKey="Z" 
     Text="Press Alt-Z to get focus here" 
     Columns="45"
     runat="server"/>
 
 </form>
 
 </body>
 </html>

Comentários

Use a AccessKey propriedade para especificar o atalho de teclado para o controle do servidor Web. Isso permite que você navegue rapidamente até o controle pressionando a tecla ALT e a tecla para o caractere especificado no teclado. Por exemplo, definir a chave de acesso de um controle para a cadeia "D" de caracteres indica que o usuário pode navegar até o controle pressionando ALT+D.

Somente uma única cadeia de caracteres é permitida para a AccessKey propriedade. Se você tentar definir essa propriedade como um valor que não seja, nullEmptynem uma única cadeia de caracteres, uma exceção será gerada.

Observação

Essa propriedade tem suporte apenas no Internet Explorer 4.0 e posterior.

Aplica-se a

Confira também