WebControl.AccessKey Propriété

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 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 essayez 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.

Notes

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

S’applique à

Partager via