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ında bulunan bir Web kullanıcısı denetimi gösterilir. 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 istemci betiği aracılığıyla ayarlanır, böylece Web sayfasının bu değeri ayarlamak için sunucuya geri göndermesi gerekmez. İ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 olmasını sağlamak 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 örnek, kullanıcı denetimini içeren içerik sayfasını gösterir.

<%@ 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 öğelerini belirtmek için de kullanılır. Örneğin, aşağıdaki CSS stil kuralı özniteliği değerine ProductIDLabel sahip id olan 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 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. 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

Ayrıca bkz.