服务器控件的三个ID

服务器控件的三个ID
2011年05月22日
　　在ASP.NET 的服务器端控件中有三种关于 ID 的属性，即 ID, ClientID 和 UniqueID。
　　ID 表示控件的服务器端编程的标识符，我们写"服务器端的代码"，就要用到这个 ID, 通过这个 ID 可以在服务器端对服务器端控件的属性、方法和时间进行编程访问。（可写）
　　ClientID 表示由服务器端生成的客户端控件的ID,"经常用于在客户端脚本中访问服务器控件所呈现的 HTML 元素"。一般情况下与服务器端的 ID 相同，有时，不能为控件生成唯一的名称，例如，如果Repeater 空间在它的某个模板中包含一个 Label 控件，则将在客户端生成多个该 Lable 的 HTML 元素, 为防止命名冲突，ASP.NET 为各个服务器控件生成一个唯一的 ClientID ,ClientID 通过将子控件的父控件的 UniqueID 值与控件的 ID 值连接生成，各个部分之间以下划线 _ 连接。（只读）
　　UniqueID 用于获取服务器控件的唯一的、以分层方式表示的标识符。当将控件放置到重复控件（Repeater、DataList和DataGrid）中时，将可能生 成多个服务器端的控件，这就需要区分服务器端的各个控件，以使它们的 ID 属性不冲突。UniqueID 通过将子控件的父控件的 UniqueID 值与控件的 ID 值连接生成，各个部分之间以IdSeparator 属性指定的字符连接。默认情况下， IdSeparator 属性为冒号字符 (:)。此属性为在 .Net Framework2.0种新增加。js与aps.net交互一般情况下使用就OK了,但如果用到母版 页(MasterPage)则要使用UniqueID获得获值。（只读）
　　例如，创建以下 ASP.NET 服务器控件：
　　asp:textbox id="TextBox1" runat="server" text="Sample Text" />
　　ClientID 属性被设置为 TextBox1，在基于 HTML 的浏览器中，其结果元素与以下所示类似：
　　
　　可以使用这些属性在客户端脚本中引用服务器控件。通常，必须在客户端脚本中用完全限定引用来引用控件；如果控件是页面中 form 元素的子控件，则一般使用document.forms[0].TextBox1.value = "New value"在客户端脚本中引用控件。
　　有些控件将子控件呈现在页面中。这些控件中包括数据列表控件（如GridView、DetailsView、FormView、DataList 和 Repeater 控件）、用户控件和 Web 部件控件。可以看到，在这些情况下，子控件可能不具有唯一的 ID，这可能是因为子控件是在某个模板中定义的，该模板会为每个数据行（数据列表控件）生成新的控件实例，也可能是因为可以从外部源（用户控件和 Web 部件控件）将父控件添加到页面中对于每个子控件：控件的 UniqueID 被呈现为 name。控件的 ClientID 被呈现为 id 属性。
　　ClientID 和 UniqueID 属性都基于原始的 ID 属性，并用足够的信息进行了修改，以保证页面中结果的唯一性。ClientID的值可在客户端脚本中引用。如果在浏览器中显示一个具有命名容器的页面，则 可以查看该页面的源文件，从中找到唯一的 ID，这些 ID 作为命名容器子控件的 name 属性和 id 属性生成。但是，建议不要依赖于直接引用在浏览器中看到的 ID。因为用于生成子控件唯一ID 的公式可能会发生变化，应当获取子控件的 ClientID 属性值，并用该值来引用该子控件。例如，您可能会在页面中动态创建客户端脚本。如果客户端脚本引用一个子控件，则应获取该子控件的 ClientID 属性，并将其嵌入到动态脚本中。
　　例2：
　　假设有子控件：
　　asp:TextBox ID = "textboxInfo" runat ="server" Text = "Test Text box" name="haha">asp:TextBox>
　　那么我们可以在脚本中这样写
　　var tempt = '';
　　var controlname = document.getElementById(tempt).name;
　　var controlid = document.getElementById(tempt).id;
　　　　还有一个问题我们需要注意：在使用UniqueID和ClientID的时候要小心点，千万不要“迫不及待”地使用了这些属性，在运行的过程中可能会碰到一些让人头疼的问题.
　　注意
　　除了用来分隔 ID 值的是下划线字符而不是 IdSeparator 属性指定的字符以外，为控件生成的 ClientID 值与 UniqueID 值相同。默认情况下，IdSeparator 属性设置为冒号字符 (:)。由于 ClientID 值不包含冒号字符，因此，它可以用于不支持包含冒号的 ID 的 ECMAScript。ClientID 值经常用于以编程方式访问为客户端脚本中的控件呈现的 HTML 元素。有关详细信息，请参见 ASP.NET 网页中的客户端脚本。
　　总结：
　　ID，用于server端编程引用控件，没有对应的client值，即不呈现到html中。
　　UniqueID，
　　asp.net引擎按控件树层次生成的分层形式限定的标志符，连接符默认为 $ （美元符号）【注：MSDN说默认为 : （冒号），实际是 $ ，可能文档有误吧】，此连接符在asp.net 2.0 中由属性 IdSeparator 指定，在client中呈现为html元素的name属性
　　此属性主要用来提交（PostBack）客户端数据，如Request.Form[someControl.UnqiueID]
　　ClientID，
　　由父控件的UnqiueID连接本身ID而成，但是连接符不一样，默认为 _ （下划线），此连接符在asp.net 2.0 中由属性 ClientIDSeparator 指定，在client中呈现为html元素的id属性，此属性主要在客户端教本中使用，如 var o = document.getElementById('');
　　关于 UniqueID的层次分隔符号，1.x 中为 :（冒号），而 2.0 已实现为 $（美元符），主要原因可能是 javascript 中标识符是允许 $，而不允许 : 的。（当你偷懒的时候，可以在 js 中直接使用表单元素的 name属性应用该表单元素，而不用 document.getElementsByName 或者 document.getElementById，不推荐:)
　　ASP.NET 使用的回发机制（简单版本）是通过一个原型为 __doPostBack(, ) 的 javascript 函数
　　function __doPostBack(eventTarget, eventArgument) {
　　if (!theForm.onsubmit || (theForm.onsubmit() != false)) {
　　theForm.__EVENTTARGET.value = eventTarget;
　　theForm.__EVENTARGUMENT.value = eventArgument;
　　theForm.submit();
　　}
　　}
　　此函数的第一个参数 对应引起页面回发控件的客户端 name 属性/服务端 UniqueID 属性，当用户引发一个事件，如点击按钮，选择列表框的某一项，首先通过 _doPostBack 函数将此值存在隐藏域中，然后提交页面。
　　在服务器端，ASP.NET 引擎通过 HttpRequest.HttpMethod 确定请求是否为 post 方式，若是，则检索HttpRequest.Request.Form["__EVENTTARGET']， 获取引发回发的控件唯一标识符，并在页面控件集合层次中查找，若找到此控件，则将在适当阶段引发服务器端事件。
　　另补充控件变化规律如下:
　　控件名字发生变化是因为 INamingContainer这个接口。这个接口没有任何方法，仅只作为一个标记。ASP.NET维护控件name和id生成的规律 是:NamingContainer爷爷$NamingContainer爸爸$该控件的ID。id则一般将$换为"_"。
　　你把控件直接放到form下，它头顶唯一一个NamingContainer是Page，但是这个是特殊的逻辑，不会生成__Page_控件名，所以就只剩控件名了，于是ID看起来没有变化。
　　当你把控件放到Repeater中时，Repeater自己被INamingContainer标记，同时，每一次循环，它会把模板内的控件重新生成一 遍，同时生成一个RepeaterItem， 把这些根据模板生成的控件加入RepeaterItem的子控件。这个RepeaterItem也是一个NamingContainer. 于是控件中就会带有:
　　RepeaterID(Data)_RepeaterItemID(ctl + 号码)_控件ID.
　　不过非runat=server控件因为不由ASP.NET维护, 不会发生变化. UserControl.ascx由于其基类也是一个NamingContainer, 所以如果你把控件放入.ascx, 然后在页面上引用, 则前面又会多一层UserControl的ID.
　　通过controls集合访问服务器控件：
　　在VS2005中新建一个.aspx文件，打开HTML页会发现一个原先的声明从
　　
　　变成了
　　!
　　很早以前就称的HTML的接班人XHTML，现在MS终于要将它扶正了..
　　这样在写HTML代码时就要注意了,
　　如:
　　
　　
　　
　　
　　是无法在Vs2005中的Design模式中正确显示的[很明显的错误，但在HTML可以正常显示].. ,XHTML的语法比HTML严格的
　　多
　　而关于XHTML和HTML的区别，如果不是非常明白http://www.blueidea.com/tech/site/2004/1911.asp这个文章可以参考一下。
　　Form
　　Form新添加了几个功能比较有用的是defaultbutton、defaultfocus。从字面的意思大家就可以理解了以前在ASP.NET 中让人头痛的默认提交表单按钮和设置焦点在ASP.NET 2.0已经提供了，不用象以前那样自己写javascript来控制了
　　关于焦点在也可以代码中通过 this.SetFocus()来设置了,看得出来ASP.NET2.0是设计是多么的细致。
　　Header
　　在代码中可能通过
　　this.Header.Metadata.Add("taye", "value");
　　this.Header.Title = "value";
　　this.Header.LinkedStyleSheets.Add("style.css");
　　来控制Title,Meta,Style等[好象LinkedStyleSheets只能是text/css???]
　　this.Header.StyleSheet.RegisterStyle()
　　方法将一个style内嵌到网页中去.
　　这样页面几乎所以部分都可以得到控制了
　　有些人也许会想那和呢
　　我们先来运行一下面这个代码.
　　private void Page_Load(object sender, EventArgs e)
　　{
　　foreach (Control ctl in Page.Controls)
　　{
　　Response.Write(ctl.ToString() + "");
　　LiteralControl lc = ctl as LiteralControl;
　　if (lc != null)
　　{
　　Response.Write(lc.Text);
　　}
　　}
　　}
　　你将会看到一个正常页的有如下五个控件
　　System.Web.UI.LiteralControl
　　System.Web.UI.HtmlControls.HtmlHead
　　System.Web.UI.LiteralControl
　　System.Web.UI.HtmlControls.HtmlForm
　　System.Web.UI.LiteralControl
　　而三个LiteralControl的控件的内容分别为
　　System.Web.UI.LiteralControl
　　
　　
　　System.Web.UI.LiteralControl
　　
　　System.Web.UI.LiteralControl
　　
　　
　　所以如果你要对body或..>或进行控制那你就找到这相应的控件以后再进行相应的修改吧。只要对
　　LiteralControl.Text进行修改就可以.
　　--------------------------------------------------------------------------
　　从外部的js文件中获取ASPX页面的控件ClientID
　　前言
　　当使用MasterPage、UserControl等容器时，为了避免控件的重复命名，asp.net会自动将容器中的控件生成一个ClientID（Control Tree中的可生成，否则不会生成）。
　　例如：ContentPlaceHolder1中的Button1默认情况下会生 “ctl00_ContentPlaceHolder1_Button1”的ClientID。我们在Render出来的mark up中看到的也是这些ClientID。所以，当我们使用JavaScript对控件元素进行操作的时候，必须使用ClientID来对控件进行查找。
　　Inline情况下的解决方案
　　如果JavaScript代码写在.aspx文件中时，也就是Inline Script时。在页面生成的时候，我们能够通过绑定机制将控件的ClientID绑定到页面Mark up中，故可使用：
　　-->document.getElementById("" )
　　来获取一个控件的真实引用，当然，FindControl等方法也可以写在...%>中用来绑定服务端数据到客户端。
　　external JS情况下的解决方案
　　然而，部分情况下，为了解耦，我们常常把JavaScript单独写在.js文件中，再引用到aspx文件中去。这种情况下，.js文件内的代码不能通过...%>来进行服务端数据的绑定，所以上面的方法是不能用的。
　　此时简单点的解决方案就是直接在JavaScript中写控件的ClientID，但这样增加了JS文件和ASPX的耦合度，非常不推荐使用。
　　我常用的方法有两种，在此抛砖引玉：
　　案例：
　　Default5.aspx是MasterPage.master 的内容页，本例中的主要文件。
　　JScript.js是一个外部的js文件，用来处理JavaScript操作。
　　Button1是Default5.aspx中的一个ASP:Button>，用来显示效果。
　　Button2是Default5.aspx中的一个，用来触发JavaScript。
　　需求：点击Button2，将Button1上的文本改成“from extended js”
　　方案一：使用内联JS访问器
　　要想在外部JS中获得ASPX动态生成的ClientID，可以通过在ASPX页面中添加访问器的方式来实现，类似OO语言中的属性：
　　我们在Default5.aspx中添加如下代码：作用：①声明getClientId访问器，并注册Button1的ClientID。②引用JScript.js文件
　　-->
　　function getClientId()
　　{
　　var paraId1 = '';
　　return {Id1:paraId1};
　　}
　　
　　
　　接下来，我们在JScript.js中，就可以这样来实现需求：
　　-->function ChangeText()
　　{
　　var btn=document.getElementById(getClientId().Id1);
　　btn.value="from extended js";
　　}
　　getClientId().Id1 貌似很OO，而且还支持VS2008很蹩脚的JS智能提示，打上“.”之后就可以在提示中选择Id1了。
　　如果有多个控件需要注册，只需将他们注册到访问器中即可，下面是一个完整的Demo代码：
　　>//引用外部js
　　asp:Content>
　　asp:Content ID="Content2" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">
　　asp:TextBox ID="TextBox1" runat="server">asp:TextBox>
　　asp:Button ID="Button1" runat="server" Text="Button" />
　　
　　asp:Content>
　　function ChangeText()
　　{
　　var btn=document.getElementById(getClientId().Id1);
　　btn.value="from extended js";
　　var btn=document.getElementById(getClientId().Id2);
　　btn.value="from extended js";
　　}
　　方案二：使用JS全局变量
　　还有一种方法也比较OO，就是使用JS全局变量，同样，也需要在Default5.aspx中添加一段JS代码，作为全局变量，来提供ClientID：
　　-->
　　var globals = {};
　　globals.controlIdentities = {};
　　globals.controlIdentities.someControl1 = '';
　　globals.controlIdentities.someControl2 = '';
　　
　　
　　接下来，我们在JScript.js中，就可以这样来实现需求：
　　-->function ChangeText()
　　{
　　var btn=document.getElementById(globals.controlIdentities.someControl1);
　　btn.value="from extended js";
　　}
　　globals.controlIdentities.someControl1，同样，也支持VS2008很蹩脚的JS智能提示，打上“.”之后就可以在提示中选择someControl1了。下面是一个完整的Demo代码：
　　>
　　asp:Content>
　　asp:Content ID="Content2" ContentPlaceHolderID="ContentPlaceHolder1" Runat="Server">
　　asp:TextBox ID="TextBox1" runat="server">asp:TextBox>
　　asp:Button ID="Button1" runat="server" Text="Button" />
　　
　　asp:Content>
　　function ChangeText()
　　{
　　var btn=document.getElementById(globals.controlIdentities.someControl1);
　　btn.value="from extended js";
　　var txt=document.getElementById(globals.controlIdentities.someControl2);
　　btn.value="from extended js";
　　}
　　结束语：
　　在上面两种方法中，也没有真正的实现aspx和js的完全解耦，所以，在js文件中，最好还是加上：
　　-->///
　　上面的方法是我常用的，今天仓促的总结了一下，希望在此能够抛砖引玉，谢谢！
　　--------------------------------------------------------------------------
　　ASP.Net中如何使用ClientID
　　ASP.Net 提供了代码和页面分离的机制，在大多数情况下，这种机制工作得非常好。但是，如果需要使用客户端java脚本来做些工作，你就会遇到麻烦了。问题出在你在 设计阶段为server端控件设置的ID值和页面运行时控件实际的ID值不一致。例如，新建一个Web site,增加一个 aspx page,在页面上加入一个text box控件：
　　asp:TextBox ID="mytext" Runat=server>asp:TextBox>
　　运行这个页面，从View source中会看到运行时的结果：
　　
　　这时我们看到设计阶段的ID值和运行时控件的ID值是一样的，没有问题，这是因为这是一个单纯的aspx页面。如果在页面中包含一个用户自定义的web control或使用了master pages (ASP.NET 2.0)，情况就不乐观了。
　　我们增加一个新的user control名为mycontrol.ascx. 在mycontrol.ascx中加入同样的text box。再把这个自定义控件加入到一个aspx 页面， 将此控件的ID设置为myControl. 在浏览器中运行这个页面，得到的html是这样的：
　　
　　text box控件的设计阶段ID= mytext，但运行时得到的ID=myControl_mytext。也就是在原来的ID前面增加了包含text box控件的容器myControl的ID。在使用master pages时，所有的aspx 页面都是被包含在一个容器中的， 而且还常常会有容器的嵌套。如果在客户端使用JavaScript去按照ID查找控件就会失败。解决这个问题可以有多个方法。
　　最简单的：
　　
　　var x=
　　function doSomething()
　　{
　　Var myControl=document.getElementById(x);
　　}
　　
　　这种方法对于一个两个控件比较适用。不过由于必须在aspx页面中设置，不能将javascript集中起来管理了。
　　那么，有没有可以不进行硬编码的方法呢?本文提供了一种方法，可以使用ASP.Net现有技术实现，并且适合所有的ASP.Net framework版本。
　　解决方案
　　关键是创建一个不会被服务器端修改的客户端控件。在自定义控件上增加一个hidden input，将它设为literal server side control：
　　asp:Literal Runat=server ID=ctrlPrefix>asp:Literal>'>
　　还要注意，这个hidden input控件需要加入到控件容器里面。因为我们后面要用它来得到控件的ID。在后台代码中对Page_Load 事件加入如下处理：
　　string []elm =ctrlPrefix.ClientID.Split('_');
　　ctrlPrefix.Text = ctrlPrefix.ClientID.Replace(elm[elm.Length - 1],"");
　　我们得到控件的client id，包含了控件的ID加上控件容器的ID作为前缀。第二行代码将ctrlPrefix.ClientID的后面一段去掉，得到容器的ID前缀，返回值包含了_。编译后运行这个页面，结果如下：
　　
　　现在，hidden input中已经保存了容器的ID前缀。下面，我们用JavaScript来利用hidden input处理控件查找。
　　增加一个新的方法getCrtlPrefix()
　　//returns the container prefix as all controls have that on their ids
　　function getCrtlPrefix()
　　{
　　var prefix;
　　var objCrtlPrefix = document.getElementById("ctrlPrefix");
　　if (objCrtlPrefix)
　　prefix = objCrtlPrefix.value;
　　return prefix;
　　}
　　这个方法得到hidden input的值并返回，这样我们就得到了ID的前缀。第二个方法用来查询空间
　　function readValue(ctrlName)
　　{
　　var prefix = getCrtlPrefix();
　　var objCrtl = document.getElementById(prefix + ctrlName);
　　if (objCrtl) alert ( "Prefix: " + prefix + " - value: " + objCrtl.value);
　　else alert("not found!");
　　}
　　这个方法显示textbox控件的值。你会注意到，这里调用了getCtrlPrefix来计算textbox控件的ClientID。 我们可以增加一个按钮来调用这个方法：
　　
　　这个html button会调用readValue。最后，把这个javascript的js文件加入aspx中。
　　
　　运行这个页面，在text box中输入写数据，然后点击按钮，会出现一个消息对话框来显示ID前缀以及text box中的数据。