Aracılığıyla paylaş

ClientIDMode Sabit listesi

Tanım

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

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

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

Alanlar

Name Değer Description
Inherit 0

Denetim, denetiminin ClientIDMode ayarını devralır NamingContainer .
AutoID 1

ClientID Değer, her üst adlandırma kapsayıcısının ID değerleri denetimin değeriyle birleştirilmesiyle ID oluşturulur. Bir denetimin birden çok örneğinin işlendiği veri bağlama senaryolarında, denetimin ID değerinin önüne artımlı bir değer eklenir. Her segment bir alt çizgi karakteri (_) ile ayrılır. Bu algoritma, ASP.NET 4'ten önceki ASP.NET sürümlerinde kullanılabilen tek algoritmadır.
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 birleştirilmesiyle ID oluşturulur. Denetim, birden çok satır oluşturan veri 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 karakteri (_) ile 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 üst kısmı olarak kullanılır.

Örnekler

Aşağıdaki örnekte, bir ListView denetimin içerdiği denetimler gösterilmektedirLabel. Denetimde ListView özelliği ClientIDMode Predictable ClientIDRowSuffix ve özelliği olarak ayarlanır ProductID. İ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ığı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ı Web.config dosyasında otomatik olarak 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 ClientIDMode bir sayfanın değerini ayarlayabilirsiniz.

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

Şunlara uygulanır

Ayrıca bkz.