WebControl.AccessKey Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo 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 de Propriedade

String

A tecla de acesso para navegação rápida para o controlo do servidor Web. O valor padrão é Empty, o que indica que esta 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 seguinte ilustra como definir e usar a AccessKey propriedade de um TextBox controlo.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

<%@ 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>

Observações

Use a AccessKey propriedade para especificar o atalho de teclado para o controlo do servidor Web. Isto permite-lhe navegar rapidamente até ao controlo pressionando a tecla ALT e a tecla do carácter especificado no teclado. Por exemplo, definir a tecla de acesso de um controlo para a cadeia "D" indica que o utilizador pode navegar até ao controlo pressionando ALT+D.

Apenas uma única cadeia de caracteres é permitida para a AccessKey propriedade. Se tentar definir esta propriedade para um valor que não seja nem null, Empty, nem uma única cadeia de caracteres, é lançada uma exceção.

Note

Esta propriedade é suportada apenas no Internet Explorer 4.0 e versões posteriores.

Aplica-se a

Ver também