开发部署带有自定义用户控件的WebPart全过程
开发部署带有自定义用户控件的WebPart全过程
说明：在创建此项目前，安装了一系列的插件：
包括：
Vs2005 sp1
VSeWSS.exe ---(webpart模板)
OfficeServerSDK.exe
VSTO+2005+SE.exe
一、创建用户控件
在VS2005中，新建一个项目：ASP.net WEB应用程序。起名为：
MyUserControlTest1，如下图：
自动生成项目：MyUserControlTest1和解决方案MyUserControlTest1。
在解决方案的资源管理器中，会自动自成一个Default.aspx文件。删除Default.aspx文件。
在项目MyUserControlTest1中，添加现在项，选择“web 用户控件”，如图：
用户控件名：MyWebUserControl.ascx。
在用户控件中添加一个日历控件Calendar1。
在MyWebUserControl.ascx.cs文件中添加一行后台代码：
protected void Page_Load(object sender, EventArgs e)
{
this.Calendar1.ToolTip = "这是eNet自定义的用户控件（最简单的日历）";
}
如下图：
编译项目。到此，用户控件就开发完了。该用户控件包含的下面的三个文件是在webpart中需要使用的：
MyWebUserControl.ascx
MyWebUserControl.ascx.cs
MyWebUserControl.ascx.designer.cs
如下图：
二、创建webpart
1、创建项目：
在解决方案中添加新项目：
MyWebPart，如图：
2、添加用户控件。
在资料管理器中点击MyWebPart项目，右键，添加现有项，将刚才的用户控件的三个文件全部添加进来。
说明：用户控件生成的DLL文件不需要引用进来。
3、修改MyWebPart.cs后台代码：
在 MyWebPart.cs文件中，添加System.IO的引用。
private System.Web.UI.Control _innerControl;
重写：CreateChildControls
protected override void CreateChildControls()
{
using (StreamReader reader = new StreamReader(System.Reflection.Assembly.GetExecutingAssembly().GetManifestResourceStream("SampleWebPart.WebUserControl1.ascx")))
{
String resourceContent = reader.ReadToEnd();
using (StreamWriter writer = new StreamWriter(this.Page.Server.MapPath("/bin/MyWebUserControl.ascx"), false))
{
writer.Write(resourceContent);
}
}
this._innerControl = this.Page.LoadControl("/bin/MyWebUserControl.ascx");
this.Controls.Add(this._innerControl);
}
在Render事件中如下代码：
protected override void Render(HtmlTextWriter writer)
{
this.EnsureChildControls();
this._innerControl.RenderControl(writer);
}
完整的代码如下：
using System;
using System.Runtime.InteropServices;
using System.Web.UI;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Serialization;
using Microsoft.SharePoint;
using Microsoft.SharePoint.WebControls;
using Microsoft.SharePoint.WebPartPages;
using System.IO;
namespace MyWebPart
{
[Guid("9a7ee2e6-ebff-4594-a3e3-d59aceae4e45")]
public class MyWebPart : System.Web.UI.WebControls.WebParts.WebPart
{
public MyWebPart()
{
this.ExportMode = WebPartExportMode.All;
}
protected override void Render(HtmlTextWriter writer)
{
this.EnsureChildControls();
this._innerControl.RenderControl(writer);
}
private System.Web.UI.Control _innerControl;
protected override void CreateChildControls()
{
using (StreamReader reader = new StreamReader(System.Reflection.Assembly.GetExecutingAssembly().GetManifestResourceStream("SampleWebPart.WebUserControl1.ascx")))
{
String resourceContent = reader.ReadToEnd();
using (StreamWriter writer = new StreamWriter(this.Page.Server.MapPath("/bin/MyWebUserControl.ascx"), false))
{
writer.Write(resourceContent);
}
}
this._innerControl = this.Page.LoadControl("/bin/MyWebUserControl.ascx");
this.Controls.Add(this._innerControl);
}
}
}
注意：MyWebUserControl.ascx文件名要和你用户控件的文件名一致。
看代码可以看出，加载webpart时，会在你所部署的网站的bin目录下自动生成文件：MyWebUserControl.ascx
4、修改AssemblyInfo.cs文件：
在项目的AssemblyInfo.cs文件中添加引用：
using System.Security;
在最后添加一行：[assembly :AllowPartiallyTrustedCallers()]
编译，生成MyWebPart.dll文件，到此，webpart开发完毕。
三、部署webpart
1、将MyWebPart.dll拷贝到你需要使用该WEB部件的网站的bin目录下。（注意：只需要这一个文件，其它的文件就不需要了）
2、修改web.config文件：添加一行到safeControl小节。如下：
<SafeControl Assembly="MyWebPart" Namespace="MyWebPart" TypeName="*" Safe="True" />
</SafeControls>
3、不用重启IIS，直接在该网站的“网站设置－修改所有网站设置－Web 部件库”中，选择新建，可以看到刚才部署的webpart了。
4、选择该webpart，然后点击“导入”按钮，即可。
四、使用开发的webpart。（略）
