不过STSDEV与微软官方所出的Visual Studio Extensions相比,易用性和稳定性稍逊一筹,我为了能够成功用STSDEV开发一个最基本的基于VS2008/3.5的webpart应用折腾了半天,为了后来的兄弟姐妹们少走弯路,故写此教程。
因本文太长,所以先做个目录,方便不同需求的兄弟们快速查看。
下载修正版STSDEV
手把手开发一个基于VS2008/3.5的webpart
创建解决方案
编辑代码
部署webpart
其他问题
感谢和引用
促进交流
下载修正版STSDEV
万事开头难,当你满怀着终于找到一个可以开发基于VS2008/3.5的webpart应用的工具STSDEV
的惊喜时候,却发现这是一个美丽的误会,这个号称能创建基于VS2008/3.5的MOSS应用的工具居然就在第一步,
创建解决方案的时候就崩溃了!
怎么办!难道就因此止步于此?从而倒退回使用DotNet3.0开发Webpart?还好,历史的车轮不会因为小小一块石头而止步,我把这个问题修复了(详见《修正版的STSDEV,可以用于开发基于dotnet3.5/vs2008的moss应用》),大家直接下载修正版STSDEV.zip,然后继续向前进吧。
手把手开发一个基于VS2008/3.5的webpart
创建解决方案
把修正版STSDEV.zip
解压到一个常用的目录,因为以后如果需要移动该目录的话将会十分麻烦(使用STSDEV创建的解决方案编译和部署的时候都需要调用STSDEV),打开STSDEVBin目录,会发现有如下文件:
双击stsdev.exe文件,就弹出一个命名行和创建解决方案向导:
然后我们:
-
输入Solution Name(解决方案),比如Adalovelacer.WebPartTest(
注意!请输入整个最顶层命名空间的名称!).
-
选择Parent Directory,这里选择C盘(
注意1:
如果Parent Directory里面所填的目录事先没有创建,将不会自动创建。所以请预先创建或者选择已有的空目录)
(
注意2:
如果Parent Directory里面所选择的目录如果有空格,比如 C:\Documents and Settings\ ,有时候会报错,有时候能创建成功,原因尚未研究。请尽量使用没有空格的目录,比如C:\Documents_and _Settings\)
-
点击Signing Key文本框旁边的…按钮,将会弹出下面对话框
这时候请直接点击Create New按钮(
注意!
不要在Textbox和点击…按钮,我已经在这里浪费了时间,不想你再在这里浪费时间),弹出如下窗口:
输入Key的文件名(
注意:这里的目录不需要跟解决方案在同一个目录下),然后点击Save按钮。出现如下界面:
点Ok.
-
然后在Solution Type中选择Web Part Solution(C# assembly)
-
在Solution/Project Version Type中选中Visual Studio 2008 with .NET 3.5
这时候界面应该如下:
这时候点击Create Solution。好!提示解决方案创建成功。
然后点击Ok之后,就会自动打开刚才创建的解决方案(
注意!只有使用修正版STSDEV.zip
才会自动打开刚才创建的解决方案,而原来版本的STSDEV是不会自动打开,需要你找到解决方案的目录,手动打开。)
好,出现如下界面:
这里有两个选项选择,第1个是浏览模式,适合只需要阅读MOSS 项目源代码而不需要修改的兄弟姐妹
(顺便赞扬一句:
STSDEV
与
Visual Studio Extensions for SharePoint v1.1
相比,除了可以创建基于
VS2008
的
DotNet3.0, 3.5Moss
解决方案,还有它不会在
VS
上装模板,是独立
VS
本身运行的,可以在默认安装的
VS
上打开,并且打开通过
STSDEV
创建的解决方案会有查看模式和编辑模式选择。这点我想对于很多只需要阅读
MOSS
项目源代码而不需要修改的兄弟姐妹们很重要。)浏览模式安全性更强,不过会屏蔽掉部分vs自动化功能和智能感应。
第2个是,我们现在是要开发而不是查看代码,所以我们选择第2个选项,普通模式。然后点ok.就打开了解决方案。
打开了解决方案之后,我们可以看到解决方案下包含下列文件夹:
其中DeploymentFiles是部署用文件夹,稍后将会提到。
RootFiles是资源文件夹,用于存放css,Image,webpart等资源文件。
除了刚才那两个文件夹外的其他地方(包括根目录下和你在DeploymentFiles、RootFiles外创建的文件夹)都是存放代码的地方。
编辑代码
编辑webpart代码主要包括以下个步骤:
1.编辑webpart的C#代码(
指
.cs
文件)
2.编辑webpart描述文件(
Template/Features/{
解决方案名称
}/WebParts
下的
.webpar
文件)
3.编辑feature.xml(
Template/Features/{
解决方案名称
}/
下的
feature.xml
文件)
4.编辑WebParts.xml(
Template/Features/{
解决方案名称
}/WebParts
下的WebParts.xml
文件)
好,现在让我们开始一个例子。这个例子是创建一个使用了
LINQ
和自动属性等
DotNet3.5
特性技术,用来显示一个数组中小于5的数字。效果如下:
既然要用LINQ,第一步当然是要添加LINQ的引用拉,
注意!LINQ的引用是System.Core
好,万事具备,我们开始按照刚才讲的4个步骤做吧,
第1步,编辑webpart的C#代码(
指.cs文件)。
先在解决方案根目录下创建一个名为HelloDotNet35.CS文件。然后把这个文件的代码修改成下面内容:
1
using
System;
2
using
System.Web;
3
using
System.Web.UI;
4
using
System.Linq;
5
using
Microsoft.SharePoint;
6
using
Microsoft.SharePoint.WebControls;
7
using
Microsoft.SharePoint.WebPartPages;
8
using
System.Web.UI.WebControls;
9
10
namespace
Adalovelacer.WebpartTest
11
{
12publicclassHelloDoNet35:WebPart
13{
14/**////<summary>
15///使用Dotnet3.5的自动属性功能
16///</summary>
17publicstringIntroduction{get;set;}
18
19protectedoverridevoidRender(HtmlTextWriterwriter)
20{
21Introduction="使用Dotnet3.5的自动属性,LINQ功能<br/>";
22writer.Write(Introduction);
23
24int[]numbers={5,4,1,3,9,8,6,7,2,0};
25
26writer.Write("在数组,<br/>");
27foreach(intiteminnumbers)
28{
29writer.Write(item+"");
30}
31writer.Write("<br/>中,小于5的数字有<br/>");
32
33
34使用LINQ检索列表#region使用LINQ检索列表
35
36varlowNums=fromnuminnumbers
37wherenum<5
38selectnum;
39
40#endregion
41
42foreach(intiinlowNums)
43{
44writer.Write(i+"");
45}
46}
47}
48}
49
第2步,编辑webpart描述文件(
Template/Features/{解决方案名称}/WebParts下的.webpar文件)
把
Template/Features/Adalovelacer.WebpartTest/WebParts/CustomWebPart1.webpart复制后,再粘贴在相同目录下,并重命名为:HelloDotNet35.webpart。
然后打开HelloDotNet35.webpart,修改成如下内容:
<?
xmlversion="1.0"encoding="utf-8"
?>
<!--
CreatedbySTSDEVat2008-3-2722:31:24
-->
<
webParts
>
<
webPart
xmlns
="http://schemas.microsoft.com/WebPart/v3"
>
<
metaData
>
<
type
name
="Adalovelacer.WebpartTest.HelloDoNet35,Adalovelacer.WebpartTest,Version=1.0.0.0,Culture=neutral,PublicKeyToken=03bd28a31f440b7b"
/>
<
importErrorMessage
>
ErrorimportingWebPart
</
importErrorMessage
>
</
metaData
>
<
data
>
<
properties
>
<
property
name
="Title"
type
="string"
>
HelloDoNet35
</
property
>
<
property
name
="Description"
type
="string"
>
欢迎大家一起探讨Webcontorl/WebpPart开发,欢迎加入msn群:[email protected]
</
property
>
<
property
name
="ChromeState"
type
="chromestate"
>
Normal
</
property
>
<
property
name
="AllowZoneChange"
type
="bool"
>
True
</
property
>
<
property
name
="AllowHide"
type
="bool"
>
True
</
property
>
<
property
name
="ExportMode"
type
="exportmode"
>
All
</
property
>
</
properties
>
</
data
>
</
webPart
>
</
webParts
>
第3步,编辑feature.xml(
Template/Features/{解决方案名称}/下的feature.xml文件)
我们打开
Template/Features/Adalovelacer.WebpartTest/feature.xml。修改成:
<?
xmlversion="1.0"encoding="utf-8"
?>
<!--
CreatedbySTSDEVat2008-3-2722:31:24
-->
<
Feature
Id
="A0D121E7-B848-4A96-85C7-A9B6A530B2F5"
Title
="Asamplefeature:Adalovelacer.WebpartTest"
Description
="ThisSharePointsolutionwascreatedbytheSTSDEVutility(http://codeplex.com/stsdev)"
Version
="1.0.0.0"
Scope
="Site"
Hidden
="false"
ImageUrl
="Adalovelacer.WebpartTest\AfricanPith32.gif"
xmlns
="http://schemas.microsoft.com/sharepoint/"
>
<
ElementManifests
>
<
ElementManifest
Location
="WebParts.xml"
/>
<
ElementFile
Location
="WebParts\CustomWebPart1.webpart"
/>
<
ElementFile
Location
="WebParts\CustomWebPart2.webpart"
/>
<!--
此处加上刚才完成的webpart文件
-->
<
ElementFile
Location
="WebParts\HelloDoNet35.webpart"
/>
<!---->
</
ElementManifests
>
</
Feature
>
第4步,编辑WebParts.xml(
Template/Features/{解决方案名称}/WebParts下的WebParts.xml
我们打开
Template/Features/Adalovelacer.WebpartTest/WebParts.xml。修改成:
1
<?
xmlversion="1.0"encoding="utf-8"
?>
2
<!--
CreatedbySTSDEVat2008-3-2722:31:24
-->
3
<
Elements
xmlns
="http://schemas.microsoft.com/sharepoint/"
>
4
<
Module
Name
="Adalovelacer.WebpartTest"
List
="113"
Url
="_catalogs/wp"
Path
="WebParts"
RootWebOnly
="True"
>
5
<
File
Url
="CustomWebPart1.webpart"
Type
="GhostableInLibrary"
>
6
<
Property
Name
="Group"
Value
="Adalovelacer.WebpartTest"
/>
7
</
File
>
8
<
File
Url
="CustomWebPart2.webpart"
Type
="GhostableInLibrary"
>
9
<
Property
Name
="Group"
Value
="Adalovelacer.WebpartTest"
/>
10
</
File
>
11
12
<!--
此处加上刚才完成的webpart文件
-->
13
<
File
Url
="HelloDoNet35.webpart"
Type
="GhostableInLibrary"
>
14
<
Property
Name
="Group"
Value
="Adalovelacer.WebpartTest"
/>
15
</
File
>
16
<!---->
17
18
</
Module
>
19
</
Elements
>
好,编译一下,全部通过了,至此代码编写工作全部完成。但是请不要关闭你的vs2008,我们还要用它来部署。
部署webpart
完成了代码编写工作之后,当然是部署拉,部署分两种,一种在本机上部署,一种在远程服务器上部署。我们先讲
在本机上部署
还好,刚才没有关闭Vs2008,我们先把编译模式选择成DebugDeploy,如下图:
编译一下,编译通过!这个时候我们已经部署到本机的wss上了。
然后我们打开wss, 然后在Team Site > Site Settings > Site Features 里面可以看到我们刚才开发的webpart集已经出来在页面中,我们点击active按钮,把它active.
然后,我们随便到一个页面上把我们的
HelloDoNet35 Webpart添加到页面上,
点add,好,终于看到我们的劳动成果了。
大功告成!但是请
注意!如果你要修改或者添加新的webpart之后,再次部署的时候请把编译模式转成DebugUpgrade(因为你已经Deploy过了),否则就会编译错误
部署到远程服务器
终于到了最后一步啦!
我们在本机打开解决方案所在目录,找到DeploymentFiles目录,把
cab结尾的文件(本例子是Adalovelacer.WebpartTest.wsp.cab)复制到远程服务器上任意一个地方(本例子为c盘)。
然后在命令提示符下敲入下列命令:
1
cd
"
C:\ProgramFiles\CommonFiles\MicrosoftShared\webserverextensions\12\bin\
"
回车
2
3
stsadm-oaddsolution-filename
"
C:\Adalovelacer.WebpartTest.wsp.cab
"
回车
4
5
stsadm-oexecadmsvcjobs回车
6
7
stsadm-odeploysolution-nameAdalovelacer
.
WebpartTest
.
wsp
.
cab-immediate-allowgacdeployment–allcontenturls回车
8
9
stsadm-oexecadmsvcjobs回车
10
好,部署成功!
打开wss, 然后在Team Site > Site Settings > Site Features 里面可以看到我们刚才开发的webpart集已经出来在页面中,我们点击active按钮,把它active.
然后,我们随便到一个页面上把我们的
HelloDoNet35 Webpart添加到页面上,
点add,好,终于看到我们的劳动成果了。
注意!如果你要修改或者添加新的webpart之后,再次部署的时候请在命令提示符下敲入下列命令:
1
cd
"
C:\ProgramFiles\CommonFiles\MicrosoftShared\webserverextensions\12\bin\
"
回车
2
3
stsadm-oupgradesolution-nameAdalovelacer
.
WebpartTest
.
wsp
.
cab-filename
"
C:\Adalovelacer.WebpartTest.wsp.cab
"
-local-allowgacdeployment回车
4
5
stsadm-oexecadmsvcjobs回车
6
至此,第一个用STSDEV开发的基于dotnet 3.5的webpart应用就此开发并部署成功。
其他问题
开发完成了,但是我想你会在STSDEV遇到这些问题:
DebugBuild
|
编译代码,生成 .wsp 文件
|
DebugInstall
|
编译代码,并安装到本地服务器。但是不部署。(如果之前使用过此模式或DebugDeploy模式编译成功,再次编译会报错)
|
DebugDeploy
|
编译代码,并安装到本地服务器。并且部署。(如果之前使用过此模式或DebugInstall模式编译成功,再次编译会报错)
|
DebugUpgrade
|
编译代码,并更新到本地服务器(如果之前没有使用DebugInstall或者DebugDeploy模式
分享到:
- 浏览: 2734445 次
- 性别:
- 来自: 大连
|
评论