WebControl.AccessKey Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur 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

Valeur de propriété

String

Touche d'accès rapide pour la navigation rapide vers le contrôle serveur Web. La valeur par défaut, Empty, indique que cette propriété n'est pas définie.

Attributs
BindableAttribute

Exceptions

ArgumentOutOfRangeException

La touche d'accès rapide spécifiée n'est ni null, ni Empty, ni une chaîne à un seul caractère.

Exemples

L’exemple suivant montre comment définir et utiliser la AccessKey propriété d’un TextBox contrôle.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de 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>

Remarques

Utilisez la AccessKey propriété pour spécifier le raccourci clavier pour le contrôle serveur Web. Cela vous permet d’accéder rapidement au contrôle en appuyant sur la touche ALT et la touche du caractère spécifié sur le clavier. Par exemple, la définition de la clé d’accès d’un contrôle sur la chaîne "D" indique que l’utilisateur peut accéder au contrôle en appuyant sur ALT+D.

Une seule chaîne de caractères est autorisée pour la AccessKey propriété. Si vous tentez de définir cette propriété sur une valeur qui n’est ni null, Empty, ni une chaîne de caractère unique, une exception est levée.

Notes

Cette propriété est prise en charge uniquement dans Internet Explorer 4.0 et versions ultérieures.

S’applique à

Voir aussi