Freigeben über

WebControl.AccessKey Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können.

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

Eigenschaftswert

String

Die Zugriffstaste für die schnelle Navigation zum Webserversteuerelement. Der Standardwert ist Empty, der angibt, dass diese Eigenschaft nicht festgelegt ist.

Attribute
BindableAttribute

Ausnahmen

ArgumentOutOfRangeException

Die angegebene Zugriffstaste ist weder nulleine Empty einzelne Zeichenfolge noch eine einzelne Zeichenfolge.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AccessKey Eigenschaft eines TextBox Steuerelements festgelegt und verwendet wird.

Von Bedeutung

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

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

Hinweise

Verwenden Sie die AccessKey Eigenschaft, um die Tastenkombination für das Webserversteuerelement anzugeben. Auf diese Weise können Sie schnell zum Steuerelement navigieren, indem Sie die ALT-TASTE und die Taste für das angegebene Zeichen auf der Tastatur drücken. Wenn Sie beispielsweise die Zugriffstaste eines Steuerelements auf die Zeichenfolge "D" festlegen, wird angegeben, dass der Benutzer durch Drücken von ALT+D zum Steuerelement navigieren kann.

Für die AccessKey Eigenschaft ist nur eine einzelne Zeichenfolge zulässig. Wenn Sie versuchen, diese Eigenschaft auf einen Wert festzulegen, der weder null, Emptynoch eine einzelne Zeichenfolge ist, wird eine Ausnahme ausgelöst.

Hinweis

Diese Eigenschaft wird nur in Internet Explorer 4.0 und höher unterstützt.

Gilt für:

Weitere Informationen