Partager via

WebControl.AccessKey Propriété

Définition

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

Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au 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

Clé d’accès pour une navigation rapide vers le contrôle serveur web. La valeur par défaut est Empty, ce qui indique que cette propriété n’est pas définie.

Attributs
BindableAttribute

Exceptions

ArgumentOutOfRangeException

La clé d’accès spécifiée n’est ni null, Empty ni une seule chaîne de caractères.

Exemples

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

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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 du 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, Emptyni une chaîne de caractères unique, une exception est levée.

Note

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

S’applique à

Voir aussi