WebControl.AccessKey Eigenschaft

Definition

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.Gets or sets the access key that allows you to quickly navigate to the Web server control.

public:
 virtual property System::String ^ AccessKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string AccessKey { get; set; }
member this.AccessKey : string with get, set
Public Overridable Property AccessKey As String

Eigenschaftswert

Die Zugriffstaste für schnelles Navigieren zum Webserversteuerelement.The access key for quick navigation to the Web server control. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default value is Empty, which indicates that this property is not set.

Attribute

Ausnahmen

Die angegebene Zugriffstaste ist weder null, noch Empty, noch eine Zeichenfolge mit einem einzigen Zeichen.The specified access key is neither null, Empty nor a single character string.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AccessKey -Eigenschaft TextBox eines-Steuer Elements festgelegt und verwendet wird.The following example illustrates how to set and use the AccessKey property of a TextBox control.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see 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 AccessKey die-Eigenschaft, um die Tastenkombination für das Webserver Steuerelement anzugeben.Use the AccessKey property to specify the keyboard shortcut for the Web server control. 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.This allows you to navigate quickly to the control by pressing the ALT key and the key for the specified character on the keyboard. Wenn beispielsweise der Zugriffsschlüssel eines Steuer Elements auf die Zeichenfolge "D" festgelegt wird, wird angegeben, dass der Benutzer durch Drücken von Alt + D zum Steuerelement navigieren kann.For example, setting the access key of a control to the string "D" indicates that the user can navigate to the control by pressing ALT+D.

Nur eine Zeichenfolge mit einem einzelnen Zeichen ist AccessKey für die Eigenschaft zulässig.Only a single character string is allowed for the AccessKey property. Wenn Sie versuchen, diese Eigenschaft auf einen Wert festzulegen, der nullweder Empty, noch eine einzelne Zeichenfolge ist, wird eine Ausnahme ausgelöst.If you attempt to set this property to a value that is neither null, Empty, nor a single character string, an exception is thrown.

Hinweis

Diese Eigenschaft wird nur in Internet Explorer 4,0 und höher unterstützt.This property is supported only in Internet Explorer 4.0 and later.

Gilt für:

Siehe auch