WebControl.AccessKey Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.
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, setmember this.AccessKey : string with get, setPublic Overridable Property AccessKey As StringЗначение свойства
Клавиша доступа для быстрого обращения к серверным веб-элементам управления. Значение по умолчанию равно Empty и показывает, что значение свойства не задано.
- Атрибуты
Исключения
Указанная клавиша доступа не является ни 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 Explorer 4.0 и более поздних версиях.
