ASP.NET 4.0配置文件中的ClientIDMode屬性詳解

更新時間：2018年11月10日 08:59:53 作者：森大科技

在ASP.NET 4.0中的每個控件上都多了一個叫做ClientIDMode的屬性，本文主要介紹了ASP.NET 4.0配置文件中的ClientIDMode屬性詳解，非常具有實用價值，需要的朋友可以參考下

時光流逝，我們心愛的ASP.NET也步入了4.0的時代，微軟在ASP.NET 4.0中對很多特性做了修改。比如我將要討論的控件ID機制就是其中之一。

在ASP.NET 4.0之前我們總是要為控件的ClientID頭疼，比如明明一個叫l(wèi)blName的Label放在一個叫做grd的GridView里面后，在頁面上改Label的ID就變成了諸如grd_clt02_lblName的一長串字符串，如果我們在前臺想在使用JS的時候找到該Label，我們不得不用到C#腳本來獲得該Label在前臺的確切ID，諸如：

< type="text/ ">
  var lblName = document.getElementById("<%=lblName.ClientID %>");
</ >

在ASP.NET 4.0中的每個控件上都多了一個叫做ClientIDMode的屬性，這就是解決上面獲取控件ID難的解決方案。這個屬性有四個可選值，根據(jù)所選值的不同它可以控制頁面上生成控件的ID格式。

下面就讓我們來了解下ClientIDMode屬性的四個值：

1，AutoID:

當控件的ClientIDMode選中為AutoID時，該控件的ClientID 值是通過串聯(lián)每個祖先容器控件（諸如GridView、ListView、LoginView等就是容器性控件）的ID和父容器控件的ID和其本身的ID 值生成的，當然如果該控件沒有在任何容器控件中其ClientID 值就是其本身的ID值，不會做任何更改。另外如果該控件所在的父容器控件或祖先容器控件有些是顯示多個數(shù)據(jù)行的容器控件（例如GridView、ListView就是顯示多數(shù)據(jù)行的容器控件），那么還將在這些容器控件的ID值的后面會插入一個遞增的行號格式。各部分之間以下劃線字符 (_) 分隔。可見在 ASP.NET 4 之前的版本中使用的就是AutoID方案來生成控件的ClientID 值。

比如下面這個GridView里面就有一個名叫Label1的ID，我們將Label1的ClientIDMode設置為了AutoID：

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" ClientIDMode="AutoID" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:Label ID="Label1" runat="server"
          Text='<%# Bind("[Account Number]") %>' ClientIDMode="AutoID"></asp:Label>
      </ItemTemplate>
    </asp:TemplateField>
  </Columns>
</asp:GridView>

該GridView生成的客戶端HTML代碼就是：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
    <th scope="col">Account Number</th>
  </tr>
    <tr>
  <td>
      <span id="grd_Account_ctl02_Label1">1060</span>
    </td>
  </tr>
    <tr>
  <td>
      <span id="grd_Account_ctl03_Label1">1200</span>
    </td>
  </tr>
    <tr>
  <td>
      <span id="grd_Account_ctl04_Label1">1510</span>
    </td>
  </tr>
</table>

可以看到GirdView里面的Label形成了諸如grd_Account_ctl02_Label1格式的ClientID，而這正是：父容器ID（grd_Account）+"_"+行號格式(ctl02)+"_"+控件自身ID（ClientID）這種格式生成的。

2，Static:

當控件的ClientIDMode選中為Static時，該控件的ClientID 值就是其本身設置的 ID 屬性值，其ClientID值不會受到父容器控件的影響。

比如我們把上面的代碼稍作修改，將Label1的ClientIDMode屬性改為Static：

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:Label ID="Label1" runat="server" Text='<%# Bind("[Account Number]") %>' ClientIDMode="Static"></asp:Label>
      </ItemTemplate>        
    </asp:TemplateField>
  </Columns>
</asp:GridView>

運行后查看得到的HTML代碼：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
    <th scope="col">Account Number</th>
  </tr><tr>
    <td>
      <span id="Label1">1060</span>
    </td>
  </tr><tr>
    <td>
      <span id="Label1">1200</span>
    </td>
  </tr><tr>
    <td>
      <span id="Label1">1510</span>
    </td>
  </tr>
</table>

看到了嗎，GridView里每行的Label1的ClientID都以自身ID的值出現(xiàn)了，不會受到父級容器控件的ID影響，這樣在前臺使用JS時我們就能通控件本身的ID值找到我們想要的控件了。

此外使用Static后勢必頁面中會出現(xiàn)很多同名的控件ID，只要這些同名ID的控件處于頁面的不同層次（比如某一容器控件的內(nèi)部和外部就是不同層次）上那么就不會出現(xiàn)問題，但是如果頁面同一層次上有多個同ID的控件，那么頁面就會報錯。

3，Inherit:

這個屬性其實沒什么好說的，如果控件的ClientIDMode選中為Inherit，那么表示該控件的ClientIDMode會使用父級容器控件的ClientIDMode值，如果父級容器控件的ClientIDMode也為Inherit，那么會使用更上層容器控件的ClientIDMode值，直到回溯到頁面的ClientIDMode值為止，頁面的ClientIDMode值默認為Predictable ，你可以在頁面上的<%@ Page%>指令中對該值做更改。此外Inherit也是ASP.NET 4.0中所有控件的ClientIDMode屬性的默認值。

4，Predictable:

首先我先說明下之所以最后寫Predictable，是因為我發(fā)現(xiàn)控件的ClientIDMode為Predictable時生成ClientID的機制會非常復雜，要分好幾個部分分別進行討論，其中還有特殊情況，所以我在這里只能說盡量將我發(fā)現(xiàn)的Predictable生成ClientID的機制闡述清楚。

當控件的ClientIDMode選中為Predictable時，該控件的ClientID 值是通過串聯(lián)父容器控件（諸如GridView、ListView、LoginView等就是容器性控件）的 ClientID 值生成的。另外如果該控件是在顯示多個數(shù)據(jù)行的父容器控件或祖先容器控件中（例如GridView、ListView就是顯示多數(shù)據(jù)行的容器控件），則還會在該控件ClientID 值的末尾添加 ClientIDRowSuffix 屬性中指定的數(shù)據(jù)字段的值。對于 GridView 控件，ClientIDRowSuffix 屬性可以指定多個數(shù)據(jù)字段。如果 ClientIDRowSuffix 屬性為空白，則在末尾添加遞增的行號，而非數(shù)據(jù)字段值。各部分之間以下劃線字符 (_) 分隔。

以上是MSDN的說法，但是經(jīng)過試驗，我發(fā)現(xiàn)Predictable的特性更應該是用這么個式子來表達：

Inherit[+"_"+ClientIDRowSuffix]

意思就是說，如果一個控件的ClientIDMode選中為Predictable，那么在ASP.NET生成該控件的ClientID時首先會去看該控件所屬的父容器控件的ClientIDMode是什么值，然后先用該控件父容器控件的ClientIDMode規(guī)則生成該控件本身的ClientID，最后如果該控件所屬的父容器控件或祖先容器控件是顯示多個數(shù)據(jù)行的容器控件，還會根據(jù)父容器控件或祖先容器控件的ClientIDRowSuffix屬性的值在該控件已生成的ClientID后面加上一個后綴字符串。

下面將幾種情況逐一列出來單獨解釋：

<1>如果父容器控件的ClientIDMode值為AutoID

如果父容器控件或祖先容器控件為顯示多個數(shù)據(jù)行的容器控件，那么該控件的ClientID格式為：[父/祖先容器控件的ID+"_"+[行號格式+"_"]]+該控件自身ID+"_"+[ClientIDRowSuffix],其中ClientIDRowSuffix部分是什么后面會單獨說明，其中：[父/祖先容器控件的ID+"_"+[行號格式+"_"]]，就是該控件自身ClientIDMode值繼承父容器控件ClientIDMode值AutoID生成的ClientID結(jié)果，其中的[行號格式+"_"]部分是否存在依賴于[父/祖先容器控件]部分是否是顯示多個數(shù)據(jù)行的容器控件(這里不明白請看前面的AutoID部分)。
如果父容器控件或祖先容器控件都不是顯示多個數(shù)據(jù)行的容器控件，那么該控件的ClientID格式為：[父/祖先容器控件的ID+"_"]+該控件自身ID，可見這個格式就是該控件自身ClientIDMode值繼承父容器控件ClientIDMode值AutoID生成的ClientID結(jié)果(這里不明白請看前面的AutoID部分)。

下面我就舉一個父容器控件是多數(shù)據(jù)行容器控件且其ClientIDMode為AutoID的例子,將上面的代碼再做更改，將Label1的ClientIDMode屬性值改為Predictable，并且設置其父容器控件grd_Account的ClientIDMode為AutoID:

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" ClientIDMode="AutoID" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:Label ID="Label1" runat="server" Text="Logged" ClientIDMode="Predictable"></asp:Label>
      </ItemTemplate>        
    </asp:TemplateField>
  </Columns>
</asp:GridView>

其生成的HTML代碼為：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
  <th scope="col">Account Number</th>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_ctl02_Label1_0">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_ctl03_Label1_1">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_ctl04_Label1_2">Logged</span>
    </td>
  </tr>
</table>

可以看到生成的Label的控件的ID諸如：grd_Account_ctl02_Label1_0正是上面所述格式：父容器控件的ID(grd_Account)+"_"+行號格式(ctl02)+"_"+該控件自身ID(Label1)+"_"+[ClientIDRowSuffix](0)。

<2>如果父容器控件的ClientIDMode值為Static

如果父容器控件或祖先容器控件為顯示多個數(shù)據(jù)行的容器控件，那么該控件的ClientID格式為：該控件自身ID+"_"+[ClientIDRowSuffix],其中ClientIDRowSuffix部分是什么后面會單獨說明，其中：該控件自身ID，就是該控件自身ClientIDMode值繼承父容器控件ClientIDMode值Static生成的ClientID結(jié)果(這里不明白請看前面的Static部分)。
如果父容器控件或祖先容器控件都不是顯示多個數(shù)據(jù)行的容器控件，那么該控件的ClientID格式為：該控件自身ID，可見這個格式就是該控件自身ClientIDMode值繼承父容器控件ClientIDMode值Static生成的ClientID結(jié)果(這里不明白請看前面的Static部分)。

下面我就舉一個父容器控件是多數(shù)據(jù)行容器控件且其ClientIDMode為Static的例子,將上面的代碼再做更改，將Label1的ClientIDMode屬性值改為Predictable，并且設置其父容器控件grd_Account的ClientIDMode為Static:

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" ClientIDMode="Static" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:Label ID="Label1" runat="server" Text="Logged" ClientIDMode="Predictable"></asp:Label>
      </ItemTemplate>        
    </asp:TemplateField>
  </Columns>
</asp:GridView>

其生成的HTML代碼為：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
  <th scope="col">Account Number</th>
  </tr>
  <tr>
  <td>
      <span id="Label1_0">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="Label1_1">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="Label1_2">Logged</span>
    </td>
    </tr>
</table>

可以看到生成的Label的控件的ID諸如：Label1_0正是上面所述格式：該控件自身ID(Label1)+"_"+[ClientIDRowSuffix](0)。

<3>如果父容器控件的ClientIDMode值為Predictable

如果父容器控件或祖先容器控件為顯示多個數(shù)據(jù)行的容器控件，那么該控件的ClientID格式為：父容器控件的ClientID+"_"+該控件自身ID+"_"+[ClientIDRowSuffix]，其中ClientIDRowSuffix部分是什么后面會單獨說明，可見這種情況才屬于MSDN上所說的格式。
如果父容器控件或祖先容器控件都不是顯示多個數(shù)據(jù)行的容器控件，那么該控件的ClientID格式為：父容器控件的ClientID+"_"+該控件自身ID，可見這種情況才是MSDN上所說的格式。

下面我就舉一個父容器控件是多數(shù)據(jù)行容器控件且其ClientIDMode為Predictable的例子,將上面的代碼再做更改，將Label1的ClientIDMode屬性值改為Predictable，并且設置其父容器控件grd_Account的ClientIDMode也為Predictable:

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" ClientIDMode="Predictable" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:Label ID="Label1" runat="server" Text="Logged" ClientIDMode="Predictable"></asp:Label>
      </ItemTemplate>        
    </asp:TemplateField>
  </Columns>
</asp:GridView>

其生成的HTML代碼為：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
  <th scope="col">Account Number</th>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_Label1_0">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_Label1_1">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_Label1_2">Logged</span>
    </td>
    </tr>
</table>

可以看到生成的Label的控件的ID諸如：grd_Account_Label1_0正是上面所述格式：父容器控件的ClientID(grd_Account)+"_"+該控件自身ID(Label1)+"_"+[ClientIDRowSuffix](0)。

<4>如果父容器控件的ClientIDMode值為Inherit

這種情況沒什么好說的，因為父容器控件的ClientIDMode值會繼承其所在更上層的祖先容器控件的ClientIDMode值，繼承后也屬于上面三種情況之一。

最后來說說ClientIDRowSuffix部分是什么，如果父容器控件或祖先容器控件是顯示多數(shù)據(jù)行的容器控件(后面會討論到如果控件的ClientIDMode為Predictable，在判斷該控件是否在顯示多數(shù)據(jù)行的容器控件中時，會有一種特殊的穿透現(xiàn)象)，那么父容器控件或祖先容器控件會有個屬性叫ClientIDRowSuffix，比如本例中的GridView的ClientIDRowSuffix屬性，這個屬性的作用是為設定ClientIDMode值為Predictable的子控件生成ClientID的后綴字符串（就是上面那些ClientID格式中的ClientIDRowSuffix部分）：

如果 ClientIDRowSuffix 屬性為空白，則在已生成的子控件ClientID末尾添加遞增的行號并在行號前面加上下劃線字符 (_) 分隔，比如上面的例子中由于都沒有在GridView上設置ClientIDRowSuffix屬性，所以ClientIDRowSuffix為空白，那么生成的子控件ClientID最末位都有諸如_0、_1、_2等的遞增行號。

此外還可以設置ClientIDRowSuffix 屬性值為父容器控件或祖先容器控件中DataSource數(shù)據(jù)源中的字段，這樣生成子控件ClientID的后綴字符串為ClientIDRowSuffix 指定字段在該行的數(shù)據(jù)值，并且ClientIDRowSuffix 屬性可指定多個DataSource數(shù)據(jù)源中的數(shù)據(jù)字段，那么在生成子控件ClientID時會將每個數(shù)據(jù)字段在該行的值用下劃線字符 (_) 進行分隔然后作為ClientID后綴字符串。

現(xiàn)在就舉個例子，將上面的代碼再做更改將Label1的ClientIDMode屬性值改為Predictable，并且設置其父容器控件grd_Account的ClientIDMode也為Predictable，并且將grd_Account的ClientIDRowSuffix設置為數(shù)據(jù)源sds_account的Account Number字段:

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" ClientIDMode="Predictable" ClientIDRowSuffix="Account Number" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:Label ID="Label1" runat="server" Text="Logged" ClientIDMode="Predictable"></asp:Label>
      </ItemTemplate>        
    </asp:TemplateField>
  </Columns>
</asp:GridView>

其生成的HTML代碼為：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
  <th scope="col">Account Number</th>
  </tr>
    <tr>
  <td>
      <span id="grd_Account_Label1_1060">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_Label1_1200">Logged</span>
    </td>
  </tr>
  <tr>
  <td>
      <span id="grd_Account_Label1_1510">Logged</span>
    </td>
    </tr>
</table>

可以看到生成子控件的ClientID的后綴字符串為Account Number字段在GridView上每行的值:1060、1200、1500，其不再是遞增的行號.

EX:最后Predictable還有一個很特別的特性：

當控件的ClientIDMode為Predictable且該控件在多個嵌套的容器控件中時，判斷該控件是否在顯示多數(shù)據(jù)行的容器控件中時，會具有層次穿透性，它不但會考察父容器控件，還會考察祖先容器控件。

下面就舉個例子來說明這種情況，首先grd_Account為顯示多數(shù)據(jù)行的容器控件，它的ClientIDMode設置為Static，在它內(nèi)部有一個ID為LoginView1的LoginView，我們知道LoginView也是容器性控件，只不過它不是顯示多數(shù)據(jù)行的容器控件，這里設置LoginView1的ClientIDMode屬性為Predictable，在LoginView1里面再放置一個ID為Label1的Label，它的ClientIDMode沒有設置，所以其值也默認繼承為Predictable，下面是代碼：

<asp:GridView ID="grd_Account" runat="server" AllowPaging="True" 
  AutoGenerateColumns="False" 
  DataKeyNames="Account Number" DataSourceID="sds_account" Height="63px" 
  Width="676px" PageSize="5" ClientIDMode="Static" >
  <Columns>
    <asp:TemplateField HeaderText="Account Number" Sort ="Account Number">
      <ItemTemplate>
        <asp:LoginView ID="LoginView1" runat="server" ClientIDMode="Predictable" >
          <LoggedInTemplate>
            <asp:Label ID="Label1" runat="server" Text="Logged"></asp:Label>
          </LoggedInTemplate>
        </asp:LoginView>
      </ItemTemplate>        
    </asp:TemplateField>
  </Columns>
</asp:GridView>

可以看到在嵌套層次結(jié)構(gòu)中，由于LoginView1所屬的父容器控件grd_Account是顯示多數(shù)據(jù)行的容器控件，所以LoginView1的ClientID應該是諸如：LoginView1_0、LoginView1_1等有ClientIDRowSuffix部分的格式，這沒有問題，但是按道理來說Label1所在的父容器控件LoginView1不是顯示多數(shù)據(jù)行的容器控件，那么Label1生成的ClientID 應該是諸如LoginView1_0_Label1、LoginView1_1_Label1等這樣的沒有ClientIDRowSuffix部分的格式，但是為我們來看一下生成的HTML代碼：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
  <th scope="col">Account Number</th>
  </tr>
  <tr>
  <td>
      <span id="LoginView1_0_Label1_0">Logged</span>  
    </td>
  </tr>
  <tr>
  <td>
      <span id="LoginView1_1_Label1_1">Logged</span> 
    </td>
  </tr>
  <tr>
  <td>
      <span id="LoginView1_2_Label1_2">Logged</span>
    </td>
  </tr>
</table>

可以看到生成的Label1的ClientID都帶表示遞增行號的后綴字符串0、1、2等（此外請注意LoginView不會產(chǎn)生HTML代碼），也就是有ClientIDRowSuffix部分。

我們再將grd_Account的ClientIDRowSuffix屬性更改為數(shù)據(jù)源中的Account Number字段后再來看看生成的HTML代碼：

<table cellspacing="0" rules="all" border="1" id="grd_Account" style="height:63px;width:676px;border-collapse:collapse;">
  <tr>
  <th scope="col">Account Number</th>
  </tr>
  <tr>
  <td> 
      <span id="LoginView1_1060_Label1_1060">Logged</span>   
    </td>
  </tr>
  <tr>
  <td> 
      <span id="LoginView1_1200_Label1_1200">Logged</span>   
    </td>
  </tr>
  <tr>
  <td>
      <span id="LoginView1_1510_Label1_1510">Logged</span>   
    </td>
  </tr>
</table>

可以看到生成的Label1的ClientID也都帶ClientIDRowSuffix部分，只不過ClientIDRowSuffix部分現(xiàn)在是數(shù)據(jù)源中Account Number字段的值。

由此可見在判斷Label1是否在顯示多數(shù)據(jù)行的容器控件中時，判定機制進行了穿透，即假如有這么一組嵌套的容器控件：Control_1<-Control_2<-Control_3<-.......<-Control1_n-1<-Control_n，其中Control_n的ClientIDMode設置或繼承為Predictable，且其中Control_2到Control1_n-1都不是顯示多數(shù)據(jù)行的容器控件，只有最外層的Control_1是顯示多數(shù)據(jù)行的容器控件，那么在判定最里面的Control_n是否在顯示多數(shù)據(jù)行的容器控件時，參考的是從里到外第一個是顯示多數(shù)據(jù)行的容器控件Control_1（即從里到外只要任意一個容器控件是顯示多數(shù)據(jù)行的容器控件，就認為Control_n是在顯示多數(shù)據(jù)行的容器控件中），并且Control_n的后綴字符串部分參考的也是Control_1的ClientIDRowSuffix屬性，從而忽略中間那些不是顯示多數(shù)據(jù)行的容器控件（Control_2到Control1_n-1），所以控件的ClientIDMode屬性為Predictable時，就是用這種穿透判定來判斷該控件是否在顯示多數(shù)據(jù)行的容器控件中的。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。