Sdílet prostřednictvím

WebControl.AccessKey Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru.

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

Hodnota vlastnosti

String

Přístupový klíč pro rychlou navigaci do ovládacího prvku webového serveru. Výchozí hodnota je Empty, což označuje, že tato vlastnost není nastavena.

Atributy
BindableAttribute

Výjimky

ArgumentOutOfRangeException

Zadaný přístupový klíč není nullani Empty řetězec s jedním znakem.

Příklady

Následující příklad ukazuje, jak nastavit a použít AccessKey vlastnost TextBox ovládacího prvku.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.

<%@ 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>

Poznámky

AccessKey Pomocí vlastnosti zadejte klávesovou zkratku pro ovládací prvek webového serveru. To vám umožní rychle přejít na ovládací prvek stisknutím klávesy ALT a klávesy pro zadaný znak na klávesnici. Například nastavení přístupové klávesy ovládacího prvku na řetězec "D" označuje, že uživatel může přejít na ovládací prvek stisknutím alt+D.

Vlastnost je povolena pouze s jedním znakovým řetězcem AccessKey . Pokud se pokusíte nastavit tuto vlastnost na hodnotu, která není null, Emptyani jeden znak řetězec, je vyvolán výjimka.

Poznámka:

Tato vlastnost je podporována pouze v aplikaci Internet Explorer 4.0 a novější.

Platí pro

Viz také