Control.ClientIDMode Properti

Referensi

Definisi

Ruang nama:: System.Web.UI

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 algoritma yang digunakan untuk menghasilkan nilai ClientID properti.

public:
 virtual property System::Web::UI::ClientIDMode ClientIDMode { System::Web::UI::ClientIDMode get(); void set(System::Web::UI::ClientIDMode value); };

[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ClientIDMode ClientIDMode { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set

Public Overridable Property ClientIDMode As ClientIDMode

Nilai Properti

ClientIDMode

Nilai yang menunjukkan bagaimana ClientID properti dihasilkan. Default adalah Inherit.

Atribut: ThemeableAttribute

Contoh

Contoh berikut menunjukkan Label kontrol yang terkandung dalam ListView kontrol. ListView Pada kontrol, ClientIDMode properti diatur ke Predictable dan ClientIDRowSuffix properti diatur ke ProductID. Dalam HTML yang dirender, ini membuat tiga span elemen yang sesuai dengan tiga ProductIDLabel kontrol. Saat halaman berjalan, id atribut untuk span elemen diatur ke nilai 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

ASP.NET menyediakan beberapa algoritma tentang cara menghasilkan ClientID nilai properti. Anda memilih algoritma mana yang akan digunakan untuk kontrol dengan mengatur propertinya ClientIDMode . Algoritma diidentifikasi oleh ClientIDMode nilai enumerasi yang tercantum dalam tabel berikut.

Nilai	Deskripsi
AutoID	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 digunakan dalam versi ASP.NET lebih lama dari ASP.NET 4.
Static	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.
Predictable	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. Angka ini dimulai pada nol dan bertambah 1 untuk setiap baris. Setiap segmen dipisahkan oleh karakter garis bawah (_).
Inherit	Kontrol mewarisi ClientIDMode pengaturan kontrolnya NamingContainer .

Nilai ClientIDMode default untuk halaman adalah Predictable. Nilai ClientIDMode default untuk kontrol adalah Inherit. Karena default untuk kontrol adalah Inherit, mode pembuatan default adalah Predictable. (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.)

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

Berlaku untuk

Bagikan melalui