首页 > 代码库 > 在ASP.NET 的服务器端控件中有三种关于 ID 的属性

在ASP.NET 的服务器端控件中有三种关于 ID 的属性

在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交互一般情况下使用<%=控件ID.ClientID%>就OK了,但如果用到母版页(MasterPage)则要使用UniqueID获得获值。(只读)

例如,创建以下 ASP.NET 服务器控件:

<asp:textbox id="TextBox1" runat="server" text="Sample Text" />

ClientID 属性被设置为 TextBox1,在基于 HTML 的浏览器中,其结果元素与以下所示类似:

<input name="TextBox1" type="text" value="http://www.mamicode.com/Sample Text" id="Text1" />

可以使用这些属性在客户端脚本中引用服务器控件。通常,必须在客户端脚本中用完全限定引用来引用控件;如果控件是页面中 form 元素的子控件,则一般使用document.forms[0].TextBox1.value = "http://www.mamicode.com/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 = ‘<%=textboxInfo.ClientID%>‘;

var controlname = document.getElementByIdx_x(tempt).name;

var controlid = document.getElementByIdx_x(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.getElementByIdx_x(‘<% = someControl.ClientID %>‘);

关于 UniqueID的层次分隔符号,1.x 中为 :(冒号),而 2.0 已实现为 $(美元符),主要原因可能是 javascript 中标识符是允许 $,而不允许 : 的。(当你偷懒的时候,可以在 js 中直接使用表单元素的 name属性应用该表单元素,而不用 document.getElementsByName 或者 document.getElementByIdx_x,不推荐:)

ASP.NET 使用的回发机制(简单版本)是通过一个原型为 __doPostBack(<ControlUniqueID>, <CommandArgs>) 的 javascript 函数

function __doPostBack(eventTarget, eventArgument) {

    if (!theForm.onsubmit || (theForm.onsubmit() != false)) {

         theForm.__EVENTTARGET.value = http://www.mamicode.com/eventTarget;

         theForm.__EVENTARGUMENT.value = http://www.mamicode.com/eventArgument;

         theForm.submit();

     }

}

此函数的第一个参数 <ControlUniqueID> 对应引起页面回发控件的客户端 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页会发现一个原先的声明从

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" >

变成了

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">!

很早以前就称的HTML的接班人XHTML,现在MS终于要将它扶正了..

这样在写HTML代码时就要注意了,

如:

<font>

    <div>

    </font>

    </div>

是无法在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内嵌到网页中去.

这样页面几乎所以部分都可以得到控制了

有些人也许会想那<html>和<body>呢

我们先来运行一下面这个代码.

   private void Page_Load(object sender, EventArgs e)

    {

        foreach (Control ctl in Page.Controls)

        {

            Response.Write(ctl.ToString() + "<BR/>");

            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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >

System.Web.UI.LiteralControl

<body>

    

System.Web.UI.LiteralControl

</body>

</html>

所以如果你要对body或<!DOCTYPE..>或<html>进行控制那你就找到这相应的控件以后再进行相应的修改吧。只要对

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.getElementByIdx_x("<%=Me.txtTest.ClientID %>" )

来获取一个控件的真实引用,当然,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中的一个<input type=button>,用来触发JavaScript。

需求:点击Button2,将Button1上的文本改成“from extended js”

方案一:使用内联JS访问器

要想在外部JS中获得ASPX动态生成的ClientID,可以通过在ASPX页面中添加访问器的方式来实现,类似OO语言中的属性:

我们在Default5.aspx中添加如下代码:作用:①声明getClientId访问器,并注册Button1的ClientID。②引用JScript.js文件

--><script type="text/javascript">

    function getClientId()

    {

     var paraId1 = ‘<%= Button1.ClientID %>‘;

     return {Id1:paraId1};

    }

</script>

<script type="text/javascript" src="http://www.mamicode.com/JScript.js"></script>

接下来,我们在JScript.js中,就可以这样来实现需求:

-->function ChangeText()

{

    var btn=document.getElementByIdx_x(getClientId().Id1);

    btn.value="http://www.mamicode.com/from extended js";

}

getClientId().Id1 貌似很OO,而且还支持VS2008很蹩脚的JS智能提示,打上“.”之后就可以在提示中选择Id1了。

如果有多个控件需要注册,只需将他们注册到访问器中即可,下面是一个完整的Demo代码:

></script>//引用外部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" />

    <input id="Button2" type="button" value="http://www.mamicode.com/button" onclick="ChangeText();" />

</asp:Content>

function ChangeText()

{

    var btn=document.getElementByIdx_x(getClientId().Id1);

    btn.value="http://www.mamicode.com/from extended js";

   

    var btn=document.getElementByIdx_x(getClientId().Id2);

    btn.value="http://www.mamicode.com/from extended js";

}

方案二:使用JS全局变量

还有一种方法也比较OO,就是使用JS全局变量,同样,也需要在Default5.aspx中添加一段JS代码,作为全局变量,来提供ClientID:

--><script type="text/javascript">

    var globals = {};

    globals.controlIdentities = {};

    globals.controlIdentities.someControl1 = ‘<%= Button1.ClientID %>‘;

    globals.controlIdentities.someControl2 = ‘<%= TextBox1.ClientID %>‘;

</script>

<script type="text/javascript" src="http://www.mamicode.com/JScript.js"></script>

接下来,我们在JScript.js中,就可以这样来实现需求:

-->function ChangeText()

{

    var btn=document.getElementByIdx_x(globals.controlIdentities.someControl1);

    btn.value="http://www.mamicode.com/from extended js";

}

globals.controlIdentities.someControl1,同样,也支持VS2008很蹩脚的JS智能提示,打上“.”之后就可以在提示中选择someControl1了。下面是一个完整的Demo代码:

></script>

</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" />

    <input id="Button2" type="button" value="http://www.mamicode.com/button" onclick="ChangeText();" />

</asp:Content>

function ChangeText()

{

    var btn=document.getElementByIdx_x(globals.controlIdentities.someControl1);

    btn.value="http://www.mamicode.com/from extended js";

   

    var txt=document.getElementByIdx_x(globals.controlIdentities.someControl2);

    btn.value="http://www.mamicode.com/from extended js";

}

结束语:

在上面两种方法中,也没有真正的实现aspx和js的完全解耦,所以,在js文件中,最好还是加上:

-->///<reference path="Default5.aspx"/>

上面的方法是我常用的,今天仓促的总结了一下,希望在此能够抛砖引玉,谢谢!

--------------------------------------------------------------------------

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中会看到运行时的结果:

<Input name="mytext" type="text" id="mytext" />

这时我们看到设计阶段的ID值和运行时控件的ID值是一样的,没有问题,这是因为这是一个单纯的aspx页面。如果在页面中包含一个用户自定义的web control或使用了master pages (ASP.NET 2.0),情况就不乐观了。

我们增加一个新的user control名为mycontrol.ascx. 在mycontrol.ascx中加入同样的text box。再把这个自定义控件加入到一个aspx 页面, 将此控件的ID设置为myControl. 在浏览器中运行这个页面,得到的html是这样的:

<Input name="myControl:mytext" type="text" id="myControl_mytext" />

text box控件的设计阶段ID= mytext,但运行时得到的ID=myControl_mytext。也就是在原来的ID前面增加了包含text box控件的容器myControl的ID。在使用master pages时,所有的aspx 页面都是被包含在一个容器中的, 而且还常常会有容器的嵌套。如果在客户端使用JavaScript去按照ID查找控件就会失败。解决这个问题可以有多个方法。

最简单的:

<script language="javascript" type ="text/javascript>

        var x=<% Response.Write("‘"+myControl.ClientId+"‘;" ) %>

        function doSomething()

        {

        Var myControl=document.getElementByIdx_x(x);

        }

</script>

这种方法对于一个两个控件比较适用。不过由于必须在aspx页面中设置,不能将javascript集中起来管理了。

那么,有没有可以不进行硬编码的方法呢?本文提供了一种方法,可以使用ASP.Net现有技术实现,并且适合所有的ASP.Net framework版本。

解决方案

关键是创建一个不会被服务器端修改的客户端控件。在自定义控件上增加一个hidden input,将它设为literal server side control:

<input type=hidden id="ctrlPrefix" name="ctrlPrefix" value=http://www.mamicode.com/‘

还要注意,这个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前缀,返回值包含了_。编译后运行这个页面,结果如下:

<input name="myControl:mytext" type="text" id="myControl_mytext" /><input type=hidden id="ctrlPrefix" name="ctrlPrefix" value=http://www.mamicode.com/‘myControl_‘>

现在,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.getElementByIdx_x("ctrlPrefix");

           if (objCrtlPrefix)

                 prefix = objCrtlPrefix.value;                

           return prefix;

}

这个方法得到hidden input的值并返回,这样我们就得到了ID的前缀。第二个方法用来查询空间

function readValue(ctrlName)

{      

var prefix = getCrtlPrefix();          

var        objCrtl = document.getElementByIdx_x(prefix + ctrlName);

           if (objCrtl)                 alert ( "Prefix: " + prefix + " - value: " + objCrtl.value);

           else                 alert("not found!");

}

这个方法显示textbox控件的值。你会注意到,这里调用了getCtrlPrefix来计算textbox控件的ClientID。 我们可以增加一个按钮来调用这个方法:

<input type=button value="http://www.mamicode.com/Read Value" onclick="javascript:readValue(‘mytext‘)">

这个html button会调用readValue。最后,把这个javascript的js文件加入aspx中。

<script language="JavaScript" src="http://www.mamicode.com/mycontrol.js"></script>

运行这个页面,在text box中输入写数据,然后点击按钮,会出现一个消息对话框来显示ID前缀以及text box中的数据。