第8章 ASP用户控件

① 打开ch8网站，选择“网站|添加新项”菜单命令，添加一个文件
名称为WebForm2.aspx的代码隐藏页模型的网页。
② 切换到网页“设计”视图，在“解决方案资源管理器”中选择
WebUserControl.ascx文件将其拖到网页上，这样在网页中生成一个名称
为WebUserControl1的用户控件。另外添加两个Button控件（“确定”命 令按钮Button1和“重置”命令按钮Button2）和一个Label控件Label1
② 选择“文件|新建|网站”命令，出现“新建网站”对话框，选择 “空网站”模板，选择“Web位置”为“文件系统”，单击
“浏览”按钮，选择“D:\\ch8”目录，单击“确定”按钮，创
建了一个空的网站ch8。
③ 选择“网站|添加新项”菜单命令，出现“添加新项-ch8”对话框，
在中间列表中选择“Web用户控件”模板，保持默认名称为
WebUserControl.ascx，如图8.1所示，单击“添加”按钮。
④ 进入用户控件的设计视图，插入一个2×2的表格，输入两个HTML
标签，拖放两个文本框（TextBox1和TextBox2），如图8.2所示。
⑤ 进入源视图，看到其源视图代码如下： <%@ Control Language="C#" AutoEventWireup="true" CodeFile="WebUserControl.ascx.cs" Inherits="WebUserControl" %> <style type="text/css"> .auto-style1 { width: 200px; } .auto-style2 { font-family: 楷体; font-size: medium; color: #0000FF; font-weight: bold; } .auto-style3 { font-family: Arial; font-weight: bold; font-size: small; } </style>
protected void Button3_Click(object sender, EventArgs e) { int i; ListItem item; for (i = 0; i < WebUserControl12.count(); i++) { item = WebUserControl12.indexitem(i); WebUserControl11.add(item); } WebUserControl12.clear(); Label1.Text = "操作成功"; } protected void Button4_Click(object sender, EventArgs e) { int i; ListItem item; i = WebUserControl12.selectedindex(); if (i >= 0 && i < WebUserControl12.count()) { item = WebUserControl12.indexitem(i); WebUserControl11.add(item); WebUserControl12.remove(i); Label1.Text = "操作成功"; } else Label1.Text = "没有选择任何选项"; }
该指令对配置及其相关属性进行定义。
用户控件不能作为独立文件运行，而必须像其他控件 一样，将其添加到网页中。
用户控件中没有html、body或form元素。
用户控件的主要优点如下：
可以将常用的内容或控件以及控件的运行程序逻辑设计为 用户控件，然后便可以在多个网页中重复使用该用户控件， 从而省略许多重复性的工作。 如果网页内容需要改变时，只需修改用户控件中的内容，
运行界面
【例8.4】 在ch8网站中设计一个WebForm2网页，其功能 是说明前面创建的WebUserControl1. ascx用户控件的使用方 法。 解：其设计步骤如下：
① 打开ch8网站，选择“网站|添加新项”菜单命令，添加一个文件
名称为WebForm2.aspx的代码隐藏页模型的网页。
设 计 界 面
在该网页上设计如下事件过程：
protected void Page_Load(object sender, EventArgs e) { if (!Page.IsPostBack) //如果网页为首次加载,则执行以下语句 { WebUserControl11.add("清华大学"); WebUserControl11.add("北京大学"); WebUserControl11.add("中国科技大学"); WebUserControl11.add("南京大学"); WebUserControl11.add("华中科技大学"); WebUserControl11.add("上海交通大学"); WebUserControl11.add("武汉大学"); Label1.Text = ""; } }
此新控件的标记与网页的标记相似，只是它包含 @Control指令，而不含@Page指令，并且用户控件没有html、body 和form元素。
8.2.2 设置用户控件
1. 设置用户控件的属性
用户控件就是一个类，其中包含的其他控件等都是私有， 外部无法访问它们。 为了能通过该类的对象访问这些私有成员，可以通过设 计属性的方式来实现。
protected void Button1_Click(object sender, EventArgs e) { int i; ListItem item; for (i = 0; i < WebUserControl11.count(); i++) { item = WebUserControl11.indexitem(i); WebUserControl12.add(item); } WebUserControl11.clear(); Label1.Text="操作成功"; } protected void Button2_Click(object sender, EventArgs e) { int i; ListItem item; i = WebUserControl11.selectedindex(); if (i >= 0 && i < WebUserControl11.count()) { item = WebUserControl11.indexitem(i); WebUserControl12.add(item); WebUserControl11.remove(i); Label1.Text = "操作成功"; } else Label1.Text = "没有选择任何选项"; }
第8章 用户控件
提供了用户控件设计功能。 用户控件基本的应用就是把网页中经常用到的程序封 装到一个单元中，以便在其他网页中使用，从而提高应用 程序开发效率。
用户控件几乎与网页.aspx文件相似，但仍有以下不同之 处：
用户控件的文件扩展名为.ascx。 用户控件中没有@Page指令，而是包含@Control指令，
上述方法都是通过ListBox控件的相关属性和方法来实现 的，只不过不能通过WebUserControl1用户控件的对象直接调 用ListBox1控件的这些属性和方法罢了，而是改为调用上述方 法实现相同的功能。
将用户控件添加到网页类似于将其他服务器控 件添加到网页。但是，请务必遵循下列过程，以便将所有必 需的元素添加到网页中。向网页添加用户控件的过 程如下：
2. 设置用户控件的方法
和设置用户控件的属性一样，可以通过设置用户控件的 公共方法来达到访问用户控件中成员的目的。
【例8.2】 创建一个用户控件WebUserControl1.ascx，其中包 含一个列表框ListBox1，并设计相关公共方法实现对列表框的操 作。 解：其设计步骤如下：
① 打开ch8网站，采用例8.1的方式创建用户控件WebUserControl1.ascx。
<table class="auto-style1"> <tr> <td class="auto-style2">学号：</td> <td> <asp:TextBox ID="TextBox1" runat="server" CssClass="auto-style3" Width="87px"></asp:TextBox> </td> </tr> <tr> <td class="auto-style2">姓名：</td> <td> <asp:TextBox ID="TextBox2" runat="server" CssClass="auto-style3" Width="85px"></asp:TextBox> </td> </tr> </table>
public void remove(int i) //删除指定索引的选项 { ListBox1.Items.RemoveAt(i); } public int selectedindex() //返回当前选择选项的索引 { return ListBox1.SelectedIndex; } public ListItem indexitem(int i) //返回指定索引的选项 { return ListBox1.Items[i]; }