WebControl.AccessKey Proprietà

Definizione

Ottiene o imposta il tasto di scelta che consente di accedere 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à

Tasto di scelta per la navigazione rapida al controllo server Web. Il valore predefinito è Empty, a indicare che questa proprietà non è impostata.

Attributi

Eccezioni

Il tasto di scelta specificato non corrisponde a null, Empty né a una stringa composta da un unico carattere.

Esempio

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

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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 solo una singola 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.

Nota

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

Si applica a

Vedi anche