WebControl.AccessKey Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen.

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

Egenskapsvärde

String

Åtkomstnyckeln för snabb navigering till webbserverkontrollen. Standardvärdet är Empty, vilket anger att den här egenskapen inte har angetts.

Attribut
BindableAttribute

Undantag

ArgumentOutOfRangeException

Den angivna åtkomstnyckeln är varken null, Empty eller en sträng med ett enda tecken.

Exempel

I följande exempel visas hur du anger och använder AccessKey egenskapen för en TextBox kontroll.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

Använd egenskapen AccessKey för att ange kortkommandot för webbserverkontrollen. På så sätt kan du snabbt navigera till kontrollen genom att trycka på ALT-tangenten och tangenten för det angivna tecknet på tangentbordet. Om du till exempel anger åtkomstnyckeln för en kontroll till strängen "D" anger det att användaren kan navigera till kontrollen genom att trycka på ALT+D.

Endast en sträng med ett tecken tillåts för egenskapen AccessKey . Om du försöker ange den här egenskapen till ett värde som varken nullär , Emptyeller en sträng med ett enda tecken genereras ett undantag.

Note

Den här egenskapen stöds endast i Internet Explorer 4.0 och senare.

Gäller för

Se även