Udostępnij za pośrednictwem

WebControl.AccessKey Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web.

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

Wartość właściwości

String

Klucz dostępu umożliwiający szybką nawigację do kontrolki serwera sieci Web. Wartość domyślna to Empty, która wskazuje, że ta właściwość nie jest ustawiona.

Atrybuty
BindableAttribute

Wyjątki

ArgumentOutOfRangeException

Określony klucz dostępu nie jest ani nulljednym Empty ciągiem znaków.

Przykłady

W poniższym przykładzie pokazano, jak ustawić i użyć AccessKey właściwości kontrolki TextBox .

Ważne

W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

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

Uwagi

Użyj właściwości , AccessKey aby określić skrót klawiaturowy dla kontrolki serwera sieci Web. Dzięki temu można szybko przejść do kontrolki, naciskając klawisz ALT i klawisz dla określonego znaku na klawiaturze. Na przykład ustawienie klucza dostępu kontrolki na ciąg "D" wskazuje, że użytkownik może przejść do kontrolki, naciskając klawisze ALT+D.

Właściwość może zawierać AccessKey tylko jeden ciąg znaków. Jeśli próbujesz ustawić tę właściwość na wartość, która nie nulljest ciągiem , Emptyani pojedynczym znakiem, zostanie zgłoszony wyjątek.

Uwaga

Ta właściwość jest obsługiwana tylko w programie Internet Explorer 4.0 lub nowszym.

Dotyczy

Zobacz też