Control.ClientIDMode Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

ö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, ClientIDMode Predictable ClientIDRowSuffix ö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ğerinin nasıl oluşturulacağı ClientID konusunda 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 Web.config dosyasında varsayılan olarak AutoID otomatik olarak ayarlar.)

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

Şunlara uygulanır