ClientIDMode Sabit listesi

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

ASP.NET istemci betiğinde ClientID erişilebilen bir denetim için öğesini nasıl oluşturduğunu belirtir.

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

Alanlar

AutoID 1

ClientID Değer, her üst adlandırma kapsayıcısının ID değerleri denetimin değeriyle ID birleştirilerek oluşturulur. Bir denetimin birden çok örneğinin işlendiği veri bağlama senaryolarında, denetimin değerinin ID önüne artan bir değer eklenir. Her segment bir alt çizgi karakteriyle (_) ayrılır. Bu algoritma, ASP.NET 4'ten önceki ASP.NET sürümlerinde kullanılabilen tek algoritmadır.
Inherit 0

Denetim, denetiminin ClientIDMode ayarını devralır NamingContainer .
Predictable 2

Bu algoritma, veriye bağlı denetimlerdeki denetimler için kullanılır. ClientID Değer, üst adlandırma kapsayıcısının ClientID değeri denetimin değeriyle ID birleştirilerek oluşturulur. Denetim, birden çok satır oluşturan veriye bağlı bir denetimse, özelliğinde ClientIDRowSuffix belirtilen veri alanının değeri sonuna eklenir. Denetim için GridView birden çok veri alanı belirtilebilir. ClientIDRowSuffix Özellik boşsa, sonuna veri alanı değeri yerine sıralı bir sayı eklenir. Her segment bir alt çizgi karakteriyle (_) ayrılır.
Static 3

ClientID değeri özelliğinin ID değerine ayarlanır. Denetim bir adlandırma kapsayıcısıysa, denetim içerdiği tüm denetimler için adlandırma kapsayıcıları hiyerarşisinin en üstünde kullanılır.

Örnekler

Aşağıdaki örnekte, bir ListView denetimde bulunan denetimler gösterilmektedirLabel. Denetiminde ListView özelliği ClientIDMode Predictable ClientIDRowSuffix , özelliği ise olarak ProductIDayarlanır. İstemci betiğinden, erişmeye çalıştığınız örneğin değerine göre ProductID belirli bir Label örneğine erişebilirsiniz.

Bu örnek, üç ProductIDLabel denetimle HTML oluşturur. Sayfa çalıştırıldığında, denetimlerin kimlikleri aşağıdaki gibi olur:

  • 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>

Açıklamalar

Bir denetimin ClientIDMode özelliğini ayarlarken numaralandırmayı ClientIDMode kullanırsınız. Özelliğine ClientIDMode atadığınız değer, özelliğin nasıl oluşturulduğunu ClientID belirler. özelliğinin ClientID değeri, işaretlemede özniteliği olarak id işlenir ve istemci betiğinden denetime erişmek için kullandığınız değerdir. özelliğine ClientIDMode atadığınız değer, sunucu denetiminin özelliğini etkilemez, yalnızca id ilgili HTML öğesinin özniteliğini etkilerID.

Bir sayfanın varsayılan değeri ClientIDMode Tahmin Edilebilir'dir. Denetimin ClientIDMode varsayılan değeri Devral'dır.

Denetimlerin varsayılanı Devral olduğundan, varsayılan oluşturma modu Tahmin Edilebilir'dir. (Ancak, bir Web projesini önceki bir sürümden ASP.NET 4'e dönüştürmek için Visual Studio kullanırsanız, Visual Studio site varsayılanını otomatik olarak Web.config dosyasında AutoID olarak ayarlar.)

Bir Web sitesindeki tüm sayfaların ClientIDMode değerini, sitenin Web.config dosyasındaki pages öğesini ayarlayarak ayarlayabilirsiniz. @ Page yönergesinde bir sayfanın değerini ayarlayabilirsinizClientIDMode.

Daha fazla bilgi için bkz. ASP.NET Web Sunucusu Denetim Kimliği.

Şunlara uygulanır

Ayrıca bkz.