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, set
member this.AccessKey : string with get, set
Public Overridable Property AccessKey As String
Значение свойства
Ключ доступа для быстрого перехода к элементу управления веб-сервера. Значение по умолчанию — это Emptyзначение, указывающее, что это свойство не задано.
- Атрибуты
Исключения
Указанный ключ доступа не является ни nullEmpty одной строкой символа.
Примеры
В следующем примере показано, как задать и использовать 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 только одна символьная строка. Если вы пытаетесь задать это свойство в значение, которое не nullEmptyявляется ни одной строкой символов, создается исключение.
Замечание
Это свойство поддерживается только в Internet Explorer 4.0 и более поздних версиях.