Aracılığıyla paylaş

Control.ClientID Özellik

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ğer tarafından 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 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 ö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

Web sunucusu denetimi bir 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 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. 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.