Control.ClientID Özellik

  • Başvuru

Tanım

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

ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır.

public:
 virtual property System::String ^ ClientID { System::String ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual string ClientID { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientID : string
Public Overridable ReadOnly Property ClientID As String

Özellik Değeri

String

ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliği.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki örneklerde, ana sayfanın içerik sayfasının içinde yer alan bir Web kullanıcı denetimi gösterilmektedir. Kullanıcı denetimi bir DropDownList denetim ve denetim Label içerir. Denetimde Label görüntülenen metin, kullanıcının denetimden DropDownList seçtiği değere göre belirlenir. Metin değeri, web sayfasının bu değeri ayarlamak için sunucuya geri göndermesi gerekmeyecek şekilde istemci betiği aracılığıyla ayarlanır. İstemci betiğinde denetim için işlenen HTML öğesine başvuru almak için Label denetimin özelliğinin ClientID değerini bilmeniz gerekir. Ancak, kullanıcı denetimi web sayfasının herhangi bir yerine yerleştirilebildiği için, hangi adlandırma kapsayıcılarının denetimleri içereceğini önceden bilmek mümkün değildir. Değerin değerle ClientID aynı ID olduğundan emin olmak için kod değeri olarak StaticayarlarClientIDMode.

Aşağıdaki örnekte kullanıcı denetimi gösterilmektedir.

<%@ Control AutoEventWireup="true" %>

<script type="text/javascript">
  var seasonalSports = new Array("None selected",
                                 "Tennis",
                                 "Volleyball",
                                 "Baseball",
                                 "Skiing");

  function DisplaySport(x) {
      document.getElementById("SelectedSport").innerHTML
      = seasonalSports[x];
  }    
</script>

<asp:DropDownList ID="DropDownList1" runat="server" 
                  onchange="DisplaySport(this.selectedIndex);">
  <asp:ListItem Value="Select a season"></asp:ListItem>
  <asp:ListItem Value="Spring"></asp:ListItem>
  <asp:ListItem Value="Summer"></asp:ListItem>
  <asp:ListItem Value="Autumn"></asp:ListItem>
  <asp:ListItem Value="Winter"></asp:ListItem>
</asp:DropDownList>
<br />
<asp:Label ID="SelectedSport" runat="server" ClientIDMode="Static">
</asp:Label>

Aşağıdaki örnekte kullanıcı denetimini içeren içerik sayfası gösterilmektedir.

<%@ Page Title="" MasterPageFile="~/Seasons.master" AutoEventWireup="true" %>

<%@ Register Src="Seasons.ascx" TagName="Seasons" TagPrefix="uc1" %>
<asp:Content ID="Content1" ContentPlaceHolderID="head" runat="Server">
</asp:Content>
<asp:Content ID="Content2" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
  <uc1:Seasons ID="Seasons1" runat="server" />
</asp:Content>

Aşağıdaki örnek, içerik sayfasını içeren ana sayfayı gösterir.

<%@ Master AutoEventWireup="true" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
    <asp:ContentPlaceHolder id="head" runat="server">
    </asp:ContentPlaceHolder>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:ContentPlaceHolder id="ContentPlaceHolder1" runat="server">
        
        </asp:ContentPlaceHolder>
    </div>
    </form>
</body>
</html>

Açıklamalar

Bir Web sunucusu denetimi html öğesi olarak işlendiğinde, id HTML öğesinin özniteliği özelliğin ClientID değerine ayarlanır. ClientID değeri genellikle yöntemini kullanarak document.getElementById istemci betiğindeki HTML öğesine erişmek için kullanılır. Kimlik genellikle CSS kurallarında stil öğeleri belirtmek için de kullanılır. Örneğin, aşağıdaki CSS stil kuralı öznitelik değerine ProductIDLabel sahip id tüm span öğeleri seçer ve özniteliklerini background-color olarak whiteayarlar:

span#ProductIDLabel { background-color: white; }

ASP.NET özellik değerinin nasıl oluşturulacağı 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 artımlı 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ı denetimlerde bulunan denetimler için kullanılır. Değer ClientID , üst adlandırma kapsayıcısının ClientID değeri denetimin değeriyle ID birleşerek 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.
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 ayarlar.)

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

Şunlara uygulanır

Ayrıca bkz.