Bagikan melalui

ClientIDMode Enum

  • Referensi

Definisi

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

Menentukan bagaimana ASP.NET menghasilkan ClientID untuk kontrol yang dapat diakses dalam skrip klien.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Warisan
Object
ValueType
Enum
ClientIDMode

Bidang

AutoID 1

Nilai ClientID dihasilkan dengan menggabungkan ID nilai setiap kontainer penamaan induk dengan ID nilai kontrol. Dalam skenario pengikatan data di mana beberapa instans kontrol dirender, nilai bertahap disisipkan di depan nilai kontrol ID . Setiap segmen dipisahkan oleh karakter garis bawah (_). Algoritma ini adalah satu-satunya yang tersedia dalam versi ASP.NET yang lebih lama dari ASP.NET 4.
Inherit 0

Kontrol mewarisi ClientIDMode pengaturan kontrolnya NamingContainer .
Predictable 2

Algoritma ini digunakan untuk kontrol yang berada dalam kontrol terikat data. Nilai ClientID dihasilkan dengan menggabungkan ClientID nilai kontainer penamaan induk dengan ID nilai kontrol. Jika kontrol adalah kontrol terikat data yang menghasilkan beberapa baris, nilai bidang data yang ditentukan dalam ClientIDRowSuffix properti ditambahkan di akhir. GridView Untuk kontrol, beberapa bidang data dapat ditentukan. ClientIDRowSuffix Jika properti kosong, angka berurutan ditambahkan di akhir, bukan nilai bidang data. Setiap segmen dipisahkan oleh karakter garis bawah (_).
Static 3

Nilai ClientID diatur ke nilai ID properti . Jika kontrol adalah kontainer penamaan, kontrol digunakan sebagai bagian atas hierarki penamaan kontainer untuk kontrol apa pun yang dikandungnya.

Contoh

Contoh berikut menunjukkan Label kontrol yang terkandung dalam ListView kontrol. ListView Pada kontrol, ClientIDMode properti diatur ke Dapat Diprediksi dan ClientIDRowSuffix properti diatur ke ProductID. Dari skrip klien, Anda dapat mengakses instans tertentu Label berdasarkan ProductID nilai instans yang coba Anda akses.

Contoh ini membuat HTML dengan tiga ProductIDLabel kontrol. Saat halaman berjalan, ID untuk kontrol akan menjadi berikut:

  • ListView1_ProductIDLabel_1
  • ListView1_ProductIDLabel_34
  • ListView1_ProductIDLabel_43
<asp:XmlDataSource ID="XmlDataSource1" runat="server" 
                   XPath="Products/Product">
  <Data>
    <Products>
      <Product ProductID="1"  ProductName="Chai" />
      <Product ProductID="34" ProductName="Ale" />
      <Product ProductID="43" ProductName="Coffee" />
    </Products>
  </Data>
</asp:XmlDataSource>

<asp:ListView ID="ListView1" 
              ClientIDMode="Predictable" 
              ClientIDRowSuffix="ProductID"  
              DataSourceID="XmlDataSource1" runat="server" >
  <ItemTemplate>
    ProductID: 
    <asp:Label ID="ProductIDLabel" runat="server" 
               Text='<%# Eval("ProductID") %>' />
    <br />
    ProductName:
    <asp:Label ID="ProductNameLabel" runat="server" 
               Text='<%# Eval("ProductName") %>' />
    <br />
    <br />
  </ItemTemplate>

  <LayoutTemplate>
    <div ID="itemPlaceholderContainer" runat="server">
      <span ID="itemPlaceholder" runat="server" />
    </div>
    <div>
    </div>
  </LayoutTemplate>
  
</asp:ListView>

Keterangan

Anda menggunakan ClientIDMode enumerasi saat mengatur ClientIDMode properti untuk kontrol. Nilai yang Anda tetapkan ke ClientIDMode properti menentukan bagaimana ClientID properti dihasilkan. Nilai ClientID properti dirender sebagai id atribut dalam markup, dan itu adalah nilai yang Anda gunakan untuk mengakses kontrol dari skrip klien. Nilai yang Anda tetapkan ke ClientIDMode properti tidak memengaruhi ID properti kontrol server, hanya id atribut elemen HTML yang sesuai.

Nilai ClientIDMode default untuk halaman dapat diprediksi. Nilai ClientIDMode default untuk kontrol adalah Warisi.

Karena default untuk kontrol adalah Warisan, mode pembuatan default dapat diprediksi. (Namun, jika Anda menggunakan Visual Studio untuk mengonversi proyek Web ke ASP.NET 4 dari versi yang lebih lama, Visual Studio secara otomatis mengatur default situs ke AutoID dalam file Web.config.)

Anda dapat mengatur ClientIDMode nilai untuk semua halaman di situs Web dengan mengatur elemen halaman dalam file Web.config situs. Anda bisa mengatur ClientIDMode nilai untuk halaman di direktif @ Halaman .

Untuk informasi lebih lanjut, lihat Identifikasi Kontrol Server Web ASP.NET.

Berlaku untuk

Lihat juga