Condividi tramite

WebControl.AccessKey Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server 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

Valore della proprietà

String

Tasto di scelta per lo spostamento rapido al controllo server Web. Il valore predefinito è Empty, che indica che questa proprietà non è impostata.

Attributi
BindableAttribute

Eccezioni

ArgumentOutOfRangeException

Il tasto di scelta specificato non nullè né , Empty né una singola stringa di caratteri.

Esempio

Nell'esempio seguente viene illustrato come impostare e utilizzare la AccessKey proprietà di un TextBox controllo .

Importante

In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di 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>

Commenti

Utilizzare la AccessKey proprietà per specificare la scelta rapida da tastiera per il controllo server Web. In questo modo è possibile passare rapidamente al controllo premendo ALT e il tasto per il carattere specificato sulla tastiera. Ad esempio, l'impostazione del tasto di scelta di un controllo sulla stringa "D" indica che l'utente può passare al controllo premendo ALT+D.

Per la AccessKey proprietà è consentita una sola stringa di caratteri. Se si tenta di impostare questa proprietà su un valore che non nullè né , Emptyné una singola stringa di caratteri, viene generata un'eccezione.

Annotazioni

Questa proprietà è supportata solo in Internet Explorer 4.0 e versioni successive.

Si applica a

Vedi anche