WebControl.AccessKey Proprietà

Definizione

Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

public:
 virtual property System::String ^ AccessKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string AccessKey { 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.The access key for quick navigation to the Web server control. Il valore predefinito è Empty, a indicare che questa proprietà non è impostata.The default value is Empty, which indicates that this property is not set.

Attributi

Eccezioni

Il tasto di scelta specificato non corrisponde a null, Empty né a una stringa composta da un unico carattere.The specified access key is neither null, Empty nor a single character string.

Esempi

Nell'esempio seguente viene illustrato come impostare e utilizzare la AccessKey proprietà di un TextBox controllo.The following example illustrates how to set and use the AccessKey property of a TextBox control.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see Script Exploits Overview.

<%@ 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 il tasto di scelta rapida per il controllo server Web.Use the AccessKey property to specify the keyboard shortcut for the Web server control. Ciò consente di spostarsi rapidamente sul controllo premendo ALT e il tasto per il carattere specificato sulla tastiera.This allows you to navigate quickly to the control by pressing the ALT key and the key for the specified character on the keyboard. Ad esempio, impostando la chiave di accesso di un controllo sulla "D" stringa si indica che l'utente può spostarsi sul controllo premendo ALT + D.For example, setting the access key of a control to the string "D" indicates that the user can navigate to the control by pressing ALT+D.

Per la AccessKey proprietà è consentita una sola stringa di caratteri.Only a single character string is allowed for the AccessKey property. Se si tenta di impostare questa proprietà su un valore che non è nullEmpty, né una singola stringa di caratteri, viene generata un'eccezione.If you attempt to set this property to a value that is neither null, Empty, nor a single character string, an exception is thrown.

Nota

Questa proprietà è supportata solo in Internet Explorer 4,0 e versioni successive.This property is supported only in Internet Explorer 4.0 and later.

Si applica a

Vedi anche