如何：访问 Web 服务器控件的命名容器的成员

项目
10/22/2014

更新：2007 年 11 月

有时，您需要访问控件的命名容器的属性或方法。例如，在数据绑定期间，命名容器可以提供包含控件所绑定的数据的 DataItem 属性。您可以根据上下文，采用不同方式来访问该包含控件。

从数据绑定表达式访问命名容器

在数据绑定表达式中，使用 Container 关键字。该关键字可以返回指向容器的引用。然后，可以访问容器的属性或方法。

在 Eval 方法中，经常使用此关键字获取命名容器的 DataItem 对象值；不过，也可以在该方法之外使用此关键字。下面的示例演示 Label 控件。该控件可能位于 DataList、Repeater 或 GridView 控件的模板中。它显示了当前项编号，后跟命名容器的当前 Title 数据项。

<asp:Label ID="Label1" runat="server">
<%# Container.DataItemIndex + 1 %>. <%# Eval("Title") %>
</asp:Label>

<asp:Label ID="Label1" runat="server">
<%# Container.DataItemIndex + 1 %>. <%# Eval("Title") %>
</asp:Label>

下面是一个类似的示例，不同之处在于它从命名容器的 DataItem 对象中获取值（Author 项）：

<asp:Label ID="Label2" runat="server" >
 <%# DataBinder.Eval(Container.DataItem, "Author") %>
</asp:Label>

<asp:Label ID="Label2" runat="server" >
 <%# DataBinder.Eval(Container.DataItem, "Author") %>
</asp:Label>

说明：
NamingContainer 属性和 Parent 属性引用的控件不必相同。例如，在 Repeater 控件中，可能有一个包含表的项模板，而该表又包含 Label 控件。标签的父级控件是表单元格（例如，HtmlTableCell 对象），但其命名容器是 DataListItem 对象，因为它是定义 Label 控件的命名空间的 DataListItem，而不是该表。

下面显示了一个使用上面显示的语法获取属性值的完整示例。

<%@ Page Language="VB" %>

<!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>Naming Container Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:XmlDataSource ID="XmlDataSource1" 
                           runat="server" 
                           XPath="Books/LanguageBooks/Book">
        <Data>
         <Books>
            <LanguageBooks>
              <Book Title="Pure JavaScript" 
                    Author="Wyke, Gilliam, and Ting"/>
              <Book Title="Effective C++ Second Edition" 
                    Author="Scott Meyers"/>
              <Book Title="Assembly Language Step-By-Step" 
                    Author="Jeff Duntemann"/>
              <Book Title="Oracle PL/SQL" 
                    Author="Steven Feuerstein"/>
            </LanguageBooks>
            <SecurityBooks>
              <Book Title="Counter Hack" 
                    Author="Ed Skoudis"/>
            </SecurityBooks>
          </Books>
        </Data>
        </asp:XmlDataSource>
        <asp:GridView ID="GridView1" 
                      runat="server" 
                      DataSourceID="XmlDataSource1" 
                      AutoGenerateColumns="False">
            <Columns>
                <asp:TemplateField HeaderText="Title" >
                    <ItemTemplate>
                        <asp:Label ID="Label1" runat="server">
                        <%# Container.DataItemIndex + 1 %>. <%# Eval("Title") %>
                        </asp:Label>
                    </ItemTemplate>
                </asp:TemplateField>
                <asp:TemplateField HeaderText="Author">
                    <ItemTemplate>
                        <asp:Label ID="Label2" runat="server" >
                         <%# DataBinder.Eval(Container.DataItem, "Author") %>
                        </asp:Label>
                    </ItemTemplate>
                </asp:TemplateField>
            </Columns>
        </asp:GridView>
    </div>
    </form>
</body>
</html>

<%@ Page Language="C#" %>

<!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>Naming Container Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:XmlDataSource ID="XmlDataSource1" 
                           runat="server" 
                           XPath="Books/LanguageBooks/Book">
        <Data>
         <Books>
            <LanguageBooks>
              <Book Title="Pure JavaScript" 
                    Author="Wyke, Gilliam, and Ting"/>
              <Book Title="Effective C++ Second Edition" 
                    Author="Scott Meyers"/>
              <Book Title="Assembly Language Step-By-Step" 
                    Author="Jeff Duntemann"/>
              <Book Title="Oracle PL/SQL" 
                    Author="Steven Feuerstein"/>
            </LanguageBooks>
            <SecurityBooks>
              <Book Title="Counter Hack" 
                    Author="Ed Skoudis"/>
            </SecurityBooks>
          </Books>
        </Data>
        </asp:XmlDataSource>
        <asp:GridView ID="GridView1" 
                      runat="server" 
                      DataSourceID="XmlDataSource1" 
                      AutoGenerateColumns="False">
            <Columns>
                <asp:TemplateField HeaderText="Title" >
                    <ItemTemplate>
                        <asp:Label ID="Label1" runat="server">
                        <%# Container.DataItemIndex + 1 %>. <%# Eval("Title") %>
                        </asp:Label>
                    </ItemTemplate>
                </asp:TemplateField>
                <asp:TemplateField HeaderText="Author">
                    <ItemTemplate>
                        <asp:Label ID="Label2" runat="server" >
                         <%# DataBinder.Eval(Container.DataItem, "Author") %>
                        </asp:Label>
                    </ItemTemplate>
                </asp:TemplateField>
            </Columns>
        </asp:GridView>
    </div>
    </form>
</body>
</html>

从代码访问命名容器

获取控件的 NamingContainer 属性，并将其强制转换为容器的类类型，如 GridViewRow。

有关示例，请参见使用 NamingContainer 属性确定控件的命名容器。

请参见

通过

如何：访问 Web 服务器控件的命名容器的成员

从数据绑定表达式访问命名容器

从代码访问命名容器

请参见

概念

参考

其他资源

其他资源