WebControl.AccessKey Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à

String

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

Attributi: BindableAttribute

Eccezioni

ArgumentOutOfRangeException

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 usare 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 proprietà per specificare il AccessKey tasto di scelta rapida per il controllo server Web. In questo modo è possibile passare rapidamente al controllo premendo il tasto ALT e il tasto per il carattere specificato sulla tastiera. Ad esempio, l'impostazione del tasto di accesso 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

Condividi tramite