WebControl.AccessKey Właściwość

Definicja

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

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

Atrybuty

Wyjątki

Określony klucz dostępu nie jest ani nullciągiem Empty pojedynczego znaku.

Przykłady

Poniższy przykład ilustruje sposób ustawiania i używania AccessKeyTextBox właściwości kontrolki.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (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

AccessKey Użyj właściwości , 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 spróbujesz ustawić tę właściwość na wartość, która nie nulljest ani 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ż