编写一个Flash播放器的WebPart
* 版权声明
* 此文章为ocean所有，版权归ocean所有，任何网站
*和 媒体转载必须包含此段声明，否则将视为侵权，作者将
* 保留一切权力。此声明为此文章中不可或缺的一部分。
* 作者网名：ocean
* 作者email： [email protected]
* 作者网站： 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中讲。