Aracılığıyla paylaş

Control.ClientIDMode Özellik

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 denetimin içerdiği denetimler gösterilmektedirLabel. Denetimde ListView özelliği ClientIDMode olarak PredictableClientIDRowSuffix , özelliği ise olarak ProductIDayarlanır. İşlenen HTML'de bu, üç span denetime karşılık gelen üç ProductIDLabel öğe oluşturur. Sayfa çalıştığı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ğerinin nasıl oluşturulacağı ClientID için birden çok algoritma sağlar. Bir denetimin özelliğini ayarlayarak ClientIDMode hangi algoritmanın 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 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ı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 üst kısmı olarak 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 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. Bu sayı sıfırdan başlar ve her satır için 1 artırılır. Her segment bir alt çizgi karakteri (_) ile ayrılır.
Inherit Denetim, denetiminin ClientIDMode ayarını devralır NamingContainer .

Bir sayfa için varsayılan değeri ClientIDMode şeklindedir Predictable. Denetimin ClientIDMode varsayılan değeri ş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 Web.config dosyasında otomatik olarak olarak AutoID olarak ayarlar.)

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

Şunlara uygulanır

Ayrıca bkz.