WebControl.AccessKey-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property AccessKey As String
'Usage
Dim instance As WebControl
Dim value As String

value = instance.AccessKey

instance.AccessKey = value

public virtual string AccessKey { get; set; }

public:
virtual property String^ AccessKey {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_AccessKey ()

/** @property */
public void set_AccessKey (String value)

public function get AccessKey () : String

public function set AccessKey (value : String)

Eigenschaftenwert

Die Zugriffstaste für schnelles Navigieren zum Webserversteuerelement. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die angegebene Zugriffstaste ist weder NULL (Nothing in Visual Basic), noch Empty, noch eine Zeichenfolge mit einem einzigen Zeichen.

Hinweise

Mit der AccessKey-Eigenschaft geben Sie die Tastenkombination für das Webserversteuerelement an. Auf diese Weise können Sie durch Drücken von ALT und der Taste für das angegebene Zeichen schnell zum Steuerelement navigieren. Wenn die Zugriffstaste für ein Steuerelement z. B. auf die Zeichenfolge "D" festgelegt wird, bedeutet dies, dass der Benutzer durch Drücken von ALT+D zum Steuerelement navigieren kann.

Für die AccessKey-Eigenschaft ist nur eine Zeichenfolge mit einem einzigen Zeichen zulässig. Wenn Sie versuchen, diese Eigenschaft auf einen Wert festzulegen, der weder NULL (Nothing in Visual Basic), noch Empty, noch eine Zeichenfolge mit einem einzigen Zeichen ist, wird eine Ausnahme ausgelöst.

Hinweis

Diese Eigenschaft wird nur in Internet Explorer ab Version 4.0 unterstützt.

Thema	Position
Gewusst wie: Hinzufügen von Button-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Eingabehilfenvalidierung von Webseiten in Visual Web Developer	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Eingabehilfenvalidierung von Webseiten in Visual Web Developer	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Button-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Eingabehilfenvalidierung von Webseiten in Visual Web Developer	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Button-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Button-Webserversteuerelementen zu einer Web Forms-Seite	Erstellen von ASP.NET-Webanwendungen

Beispiel

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

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 <body>
 
   <h3>AccessKey Property of a Web Control</h3>
 
 <form runat="server">
 
   <asp:TextBox id="TextBox1" 
     AccessKey="Y" 
     Text="Press Alt-Y to get focus here" 
     Columns="45"
     runat="server"/>
 
   <p>
 
   <asp:TextBox id="TextBox2" 
     AccessKey="Z" 
     Text="Press Alt-Z to get focus here" 
     Columns="45"
     runat="server"/>
 
 </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
 
 </head>
 <body>
 
   <h3>AccessKey Property of a Web Control</h3>
 
 <form runat="server">
 
   <asp:TextBox id="TextBox1" 
     AccessKey="Y" 
     Text="Press Alt-Y to get focus here" 
     Columns="45"
     runat="server"/>
 
   <p>
 
   <asp:TextBox id="TextBox2" 
     AccessKey="Z" 
     Text="Press Alt-Z to get focus here" 
     Columns="45"
     runat="server"/>
 
 </form>
 
 </body>
 </html>

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 <body>
 
   <h3>AccessKey Property of a Web Control</h3>
 
 <form runat="server">
 
   <asp:TextBox id="TextBox1" 
     AccessKey="Y" 
     Text="Press Alt-Y to get focus here" 
     Columns="45"
     runat="server"/>
 
   <p>
 
   <asp:TextBox id="TextBox2" 
     AccessKey="Z" 
     Text="Press Alt-Z to get focus here" 
     Columns="45"
     runat="server"/>
 
 </form>
 
 </body>
 </html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Freigeben über