Aracılığıyla paylaş

Control.ClientIDMode Özellik

  • Başvuru

Tanım

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

özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar.

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

Özellik Değeri

ClientIDMode

Özelliğin nasıl oluşturulduğunu ClientID gösteren değer. Varsayılan değer: Inherit.

Öznitelikler
ThemeableAttribute

Örnekler

Aşağıdaki örnekte, bir ListView denetimde bulunan denetimler gösterilmektedirLabel. Denetiminde ListView özelliği olarak, ClientIDModePredictableClientIDRowSuffix özelliği ise olarak ProductIDayarlanır. İşlenen HTML'de bu, üç span denetime karşılık gelen üç ProductIDLabel öğe oluşturur. Sayfa çalıştırıldığında, id öğelerin öznitelikleri span aşağıdaki değerlere ayarlanır:

  • 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

ASP.NET özellik değerini oluşturmak ClientID için birden çok algoritma sağlar. Bir denetimin özelliğini ayarlayarak hangi algoritmanın ClientIDMode kullanılacağını seçersiniz. Algoritmalar, aşağıdaki tabloda listelenen numaralandırma değerleriyle ClientIDMode tanımlanır.

Değer Açıklama
AutoID 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ılmıştır.
Static 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.
Predictable 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. Bu sayı sıfırdan başlar ve her satır için 1 artırılır. Her segment bir alt çizgi karakteriyle (_) ayrılır.
Inherit Denetim, denetiminin ClientIDMode ayarını devralır NamingContainer .

Bir sayfanın varsayılan değeri ClientIDMode şeklindedir Predictable. Bir denetim için varsayılan değeri ClientIDMode şeklindedir Inherit. Denetimlerin varsayılanı olduğundan Inherit, varsayılan oluşturma modu şeklindedir Predictable. (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 siteyi otomatik olarak Web.config dosyasında varsayılan olarak AutoID ayarlar.)

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

Şunlara uygulanır

Ayrıca bkz.