WebControl.AccessKey Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.

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 schnelles Navigieren zum Webserversteuerelement. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Attribute: BindableAttribute

Ausnahmen

ArgumentOutOfRangeException

Die angegebene Zugriffstaste ist weder null, noch Empty, noch eine Zeichenfolge mit einem einzigen Zeichen.

Beispiele

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

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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. Dadurch 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, kann der Benutzer durch Drücken von ALT+D zum Steuerelement navigieren.

Nur eine einzelne Zeichenfolge ist für die AccessKey -Eigenschaft 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:

Freigeben über