WebControl.AccessKey Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

Share via