Bagikan melalui

WebControl.AccessKey Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur kunci akses yang memungkinkan Anda menavigasi dengan cepat ke kontrol server Web.

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

Nilai Properti

String

Kunci akses untuk navigasi cepat ke kontrol server Web. Nilai defaultnya adalah Empty, yang menunjukkan bahwa properti ini tidak diatur.

Atribut
BindableAttribute

Pengecualian

ArgumentOutOfRangeException

Kunci akses yang ditentukan bukan null, Empty atau string karakter tunggal.

Contoh

Contoh berikut mengilustrasikan cara mengatur dan menggunakan AccessKey properti TextBox kontrol.

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

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

Keterangan

AccessKey Gunakan properti untuk menentukan pintasan keyboard untuk kontrol server Web. Ini memungkinkan Anda untuk menavigasi dengan cepat ke kontrol dengan menekan tombol ALT dan tombol untuk karakter yang ditentukan pada keyboard. Misalnya, mengatur kunci akses kontrol ke string "D" menunjukkan bahwa pengguna dapat menavigasi ke kontrol dengan menekan ALT+D.

Hanya string karakter tunggal yang diizinkan untuk AccessKey properti . Jika Anda mencoba mengatur properti ini ke nilai yang bukan null, , Emptyatau string karakter tunggal, pengecualian akan dilemparkan.

Catatan

Properti ini hanya didukung di Internet Explorer 4.0 dan yang lebih baru.

Berlaku untuk

Lihat juga