WebControl.AccessKey Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

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

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

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

String

Клавиша доступа для быстрого обращения к серверным веб-элементам управления. Значение по умолчанию равно Empty и показывает, что значение свойства не задано.

Атрибуты
BindableAttribute

Исключения

ArgumentOutOfRangeException

Указанная клавиша доступа не является ни null, ни Empty, ни строкой, состоящей из одного знака.

Примеры

В следующем примере показано, как задать и использовать AccessKey свойство TextBox элемента управления .

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

<%@ 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 чтобы указать сочетание клавиш для серверного веб-элемента управления. Это позволяет быстро перейти к элементу управления, нажав клавишу ALT и клавишу для указанного символа на клавиатуре. Например, установка клавиши доступа элемента управления в строке "D" означает, что пользователь может перейти к элементу управления, нажав клавиши ALT+D.

Для свойства допускается только одна символьная AccessKey строка. При попытке задать этому свойству значение, которое не является ни null, Emptyни строкой с одним символом, возникает исключение.

Примечание

Это свойство поддерживается только в Internet Обозреватель 4.0 и более поздних версиях.

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

См. также раздел