WebControl.AccessKey WebControl.AccessKey WebControl.AccessKey WebControl.AccessKey Property

Definición

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor 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

Valor de propiedad

Clave de acceso para navegar rápidamente al control de servidor web.The access key for quick navigation to the Web server control. El valor predeterminado es Empty, que indica que no se ha establecido esta propiedad.The default value is Empty, which indicates that this property is not set.

Excepciones

La clave de acceso especificada no es null, Empty ni una cadena de un solo carácter.The specified access key is neither null, Empty nor a single character string.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer y utilizar la AccessKey propiedad de un TextBox control.The following example illustrates how to set and use the AccessKey property of a TextBox control.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.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>
    

Comentarios

Utilice la AccessKey propiedad para especificar el método abreviado de teclado para el control de servidor Web.Use the AccessKey property to specify the keyboard shortcut for the Web server control. Esto le permite navegar rápidamente al control presionando la tecla ALT y la tecla del carácter especificado en el teclado.This allows you to navigate quickly to the control by pressing the ALT key and the key for the specified character on the keyboard. Por ejemplo, establecer la tecla de acceso de un control en la "D" cadena indica que el usuario puede desplazarse hasta el control presionando 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.

Solo se permite una cadena de carácter único para AccessKey la propiedad.Only a single character string is allowed for the AccessKey property. Si intenta establecer esta propiedad en un valor que no sea null, Emptyni una cadena de un solo carácter, se produce una excepción.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

Esta propiedad solo se admite en Internet Explorer 4,0 y versiones posteriores.This property is supported only in Internet Explorer 4.0 and later.

Se aplica a

Consulte también: