编写一个Flash播放器的WebPart
* 版权声明
* 此文章为ocean所有，版权归ocean所有，任何网站
*和 媒体转载必须包含此段声明，否则将视为侵权，作者将
* 保留一切权力。此声明为此文章中不可或缺的一部分。
* 作者网名：ocean
* 作者email：ocean@forever.net.cn
* 作者网站：http://www.oceanstudio.net
* http://sps.oceanstudio.net
* 作者blog：博客园，http://www.cnblogs.com/ocean
* 此文章发表时间：2005年2月3日
* 此文章源：http://www.cnblogs.com/ocean/archive/2005/02/03/101434.html
************************************************************************************
这个WebPart点击此处下载，带源码。
点击此处察看效果演示
最近看到一个老外写的一个Flash播放器的WebPart，感觉这些WebPart写起来很简单，正好也希望给初学者介绍一下如何进行WebPart的开发。我也没写过几个WebPart，因为实际上WebPart的开发是师傅领进门，修行在个人。很多初学Sharepoint的对WebPart开发摸不着头脑。实际WebPart写起来很简单，但是准备工作比较复杂，包括安装模板，引用dll，部署，调试等。这些东西我在后面的一篇文章中会介绍。另外就是WebPart的开发需要多看看sharepoint的sdk，里面讲解了组件模型，如果你的WebPart不引用任何SPS库对象（比如这个Flash WebPart），那么写起来就更简单了。
首先如何写WebPart，在新建了一个WebPart的项目之后，默认就生成了一个WebPart,这个WebPart本身就能够编译成功，当然这个WebPart是一个空的WebPart。什么功能也没有。
WebPart的呈现是靠RenderWebPart这个方法实现的，这个方法有一个output参数，只要通过output将需要呈现的HTML输出出来就可以了。熟悉asp的朋友可能很熟悉这种方式，就像用asp的Response一样。因为WebPart的呈现无法用可视化的开发。当然利用Kaneboy做的用户控件包装器可以简单的将一个用户控件包装成WebPart。
OK，那么该如何呈现呢，其实Flash的呈现代码很简单，就是输出一个object标签，然后设置flash的url、width、height等属性。那么我们需要设置哪几个属性呢？是Flash url、Width、Height、Quality、CabVersion（CAB的版本）这五个属性。
这五个属性定义如下：
private string url = "";
[Browsable(true),
Category("Flash属性"),
DefaultValue(""),
WebPartStorage(Storage.Personal),
FriendlyName("Flash Url"),
Description("Flash动画的Url")]
public string Url
{
get
{
return url;
}
set
{
url = value;
}
}
private int width = 100;
[Browsable(true),
Category("Flash属性"),
DefaultValue(100),
WebPartStorage(Storage.Personal),
FriendlyName("Flash的显示宽度(px,0表示原大小)"),
Description("Flash动画的宽度")]
public int FlashWidth
{
get
{
return width;
}
set
{
width = value;
}
}
private int height = 100;
[Browsable(true),
Category("Flash属性"),
DefaultValue(100),
WebPartStorage(Storage.Personal),
FriendlyName("Flash的显示高度(px,0表示原大小)"),
Description("Flash动画的高度")]
public int FlashHeight
{
get
{
return height;
}
set
{
height = value;
}
}
private string quality = "high";
[Browsable(true),
Category("Flash属性"),
DefaultValue("high"),
WebPartStorage(Storage.Personal),
FriendlyName("Flash显示质量"),
Description("Flash动画的显示质量")]
public string Quality
{
get
{
return quality;
}
set
{
quality = value;
}
}
private string cabversion = "7,0,0,0";
[Browsable(true),
Category("Flash属性"),
DefaultValue("7,0,0,0"),
WebPartStorage(Storage.Personal),
FriendlyName("Flash的CAB版本"),
Description("Flash的CAB版本")]
public string CabVersion
{
get
{
return cabversion;
}
set
{
cabversion = value;
}
}
默认的时候有一个Text属性，只要照猫画虎就可以了。每个属性前有一堆属性修饰。这些属性不用讲也能猜得出来意思。
然后最终的呈现代码如下：
/// <summary>
/// Render this Web Part to the output parameter specified.
/// </summary>
/// <param name="output"> The HTML writer to write out to </param>
protected override void RenderWebPart(HtmlTextWriter output)
{
try
{
if (this.url.Trim() == "")
{
output.Write(SPEncode.HtmlEncode("请选择要显示的Flash动画"));
}
else
{
output.Write("<OBJECT classid=\"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000\" codebase=\"http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=");
output.Write(SPEncode.HtmlEncode(this.cabversion) + "\" ");
output.Write(" WIDTH=\"" + this.width + "\" ");
output.Write(" \"HEIGHT=\"" + this.height + "\">");
output.Write("<PARAM NAME=movie VALUE=\"" + SPEncode.HtmlEncode(this.url) + "\"><PARAM NAME=quality VALUE=" + SPEncode.HtmlEncode(this.quality) + "><param name=wmode value=opaque>");
output.Write("<EMBED src=\"" + SPEncode.HtmlEncode(this.url) + "\" quality=" + SPEncode.HtmlEncode(this.quality));
output.Write(" WIDTH=\"" + this.width + "\" ");
output.Write(" HEIGHT=\"" + this.height + "\" ");
output.Write(" TYPE=\"application/x-shockwave-flash\" PLUGINSPAGE=\"http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash\"></EMBED></OBJECT>");
}
}
catch (Exception e)
{
output.Write("有错误发生：" + e.Message);
}
}
其中注意是当Url为空的时候提示一个需要设置属性的信息。另外就是捕获一下异常。
一个WebPart就这么轻轻松松完成了，然后就是部署了。关于WebPart的强签名和部署，我将在以后的Blog中讲。
