WebControl.AccessKey Свойство

Определение

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.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

Значение свойства

Клавиша доступа для быстрого обращения к серверным веб-элементам управления.The access key for quick navigation to the Web server control. Значение по умолчанию равно Empty и показывает, что значение свойства не задано.The default value is Empty, which indicates that this property is not set.

Атрибуты

Исключения

Указанная клавиша доступа не является ни null, ни Empty, ни строкой, состоящей из одного знака.The specified access key is neither null, Empty nor a single character string.

Примеры

В следующем примере показано, как задать и использовать AccessKey свойство TextBox элемента управления.The following example illustrates how to set and use the AccessKey property of a TextBox control.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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>
    

Комментарии

AccessKey Используйте свойство, чтобы указать сочетание клавиш для серверного веб-элемента управления.Use the AccessKey property to specify the keyboard shortcut for the Web server control. Это позволяет быстро переходить к элементу управления, нажав клавишу ALT и клавишу для указанного символа на клавиатуре.This allows you to navigate quickly to the control by pressing the ALT key and the key for the specified character on the keyboard. Например, задание клавиши доступа для элемента управления в строке "D" указывает, что пользователь может перейти к элементу управления, нажав клавиши 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.

Для AccessKey свойства допускается только одна символьная строка.Only a single character string is allowed for the AccessKey property. При попытке установить это свойство в значение, которое не является ни nullни Empty, ни одной строкой символов, создается исключение.If you attempt to set this property to a value that is neither null, Empty, nor a single character string, an exception is thrown.

Примечание

Это свойство поддерживается только в Internet Explorer 4,0 и более поздних версиях.This property is supported only in Internet Explorer 4.0 and later.

Применяется к

Дополнительно