开发与使用自定义服务器控件.docxVIP

此演练演示如何创建和编译自定义 ASP.NET 服务器控件以及如何在页中使用该控件。通过此演练，您将学会如何执行以下任务：创建一个 ASP.NET 服务器控件。向该控件及其成员添加元数据以控制安全性和设计时行为。使用 ASP.NET 网站中的 App_Code 目录对控件进行测试（无需手动编译步骤）。在配置文件和该控件的程序集中指定一个标记前缀。将该控件编译为一个程序集并将其添加到 Bin 目录中。将一个位图嵌入到该控件的程序集中，以作为可视化设计器的工具箱图标使用。在页中使用已编译的控件。可视化设计工具（如 Microsoft Visual Studio 2005）可以简化控件的开发过程，但并不是创建或生成自定义控件的必不可少的工具。可以通过使用任何文本编辑器创建控件，并使用属于 .NET Framework SDK 一部分的编译器从命令行生成这些控件。无论以何种方式创建控件，在可视化设计器中控件的设计时外观和行为都将相同。页开发人员可将控件添加到可视化设计器的工具箱，可将其拖动到设计图面上，还可以在属性浏览器中访问其属性和事件。在有些可视化设计器（如 Visual Studio 2005）中，自定义控件还可自行支持 IntelliSense。创建服务器控件要创建的控件WelcomeLabel是一个简单控件，与标准的Label控件类似。WelcomeLabel类从WebControl派生，它定义了一个Text属性，该属性允许页开发人员提供一个文本字符串，以欢迎访问站点的用户。如果用户名出现在用户浏览器发送的标题中，WelcomeLabel就会将用户名追加到该文本字符串。有关检索用户名的更多信息，请参见User。例如，如果页开发人员将“Hello”设置为Text属性的值，则根据标题中是否出现用户名，WelcomeLabel将呈现“Hello, 用户名!”或“Hello!”。创建自定义服务器控件的代码创建一个名为 WelcomeLabel.cs 或 WelcomeLabel.vb 的文件。将以下代码添加到控件的源文件中：VBC#C++F#JScript复制// WelcomeLabel.csusing System;using System.ComponentModel;using System.Security.Permissions;using System.Web;using System.Web.UI;using System.Web.UI.WebControls;namespace Samples.AspNet.CS.Controls{ [ AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal), AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal), DefaultProperty(Text), ToolboxData({0}:WelcomeLabel runat=\server\ /{0}:WelcomeLabel) ]publicclass WelcomeLabel : WebControl { [ Bindable(true), Category(Appearance), DefaultValue(), Description(The welcome message text.), Localizable(true) ]publicvirtualstring Text {get {string s = (string)ViewState[Text];return (s == null) ? String.Empty : s; }set { ViewState[Text] = value; } }protectedoverridevoid RenderContents(HtmlTextWriter writer) { writer.WriteEncodedText(Text);if (Context != null) {string s = Context.User.Id