使用STSDEV开发基于dotnet 3.5的webpart应用

STSDEV是一个优秀的Sharepoint开源开发工具，并且对于2008年中之前需要开发基于VS2008/3.5的moss webpart应用的兄弟姐妹们，更是唯一的选择。（详见 Kaneboy的《 Visual Studio Extensions for SharePoint v1.1》和 choral的《 一个SharePoint开发人员必备的工具》）。

不过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文件，就弹出一个命名行和创建解决方案向导：

然后我们：

1. 输入Solution Name(解决方案)，比如Adalovelacer.WebPartTest( 注意!请输入整个最顶层命名空间的名称！).
2. 选择Parent Directory，这里选择C盘（ 注意1: 如果Parent Directory里面所填的目录事先没有创建，将不会自动创建。所以请预先创建或者选择已有的空目录）
   （ 注意2: 如果Parent Directory里面所选择的目录如果有空格，比如 C:\Documents and Settings\ ，有时候会报错，有时候能创建成功，原因尚未研究。请尽量使用没有空格的目录，比如C:\Documents＿and ＿Settings\）
3. 点击Signing Key文本框旁边的…按钮，将会弹出下面对话框
   
   
   这时候请直接点击Create New按钮（ 注意! 不要在Textbox和点击…按钮，我已经在这里浪费了时间，不想你再在这里浪费时间），弹出如下窗口：
   
   输入Key的文件名( 注意:这里的目录不需要跟解决方案在同一个目录下)，然后点击Save按钮。出现如下界面：
   
   点Ok.
4. 然后在Solution Type中选择Web Part Solution(C# assembly)
5. 在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模式 分享到： 在WinXP or Vista上开发Webpart | 修正版的STSDEV,可以用于开发基于dotnet3. ... 2008-04-13 16:48 浏览 170 评论(0) 相关推荐 评论 发表评论 您还没有登录,请您登录后再发表评论 javatoyou 浏览: 304608 次 性别: 来自: 北京 最近访客 更多访客>> toxuxuxuan lingjun5002 dylinshi126 文章分类 全部博客 (2024) 社区版块 我的资讯 (0) 我的论坛 (0) 我的问答 (0) 存档分类 2012-02 (12) 2012-01 (12) 2011-12 (5) 更多存档... 最新评论 jingxuewang2010： gvParameter是什么？ GridView绑定xml,增,删,改,取消 学不止： ... FreeSwitch Sip lushcenter： 个人学习中！ Ajax 服务器推送 amcucn： 楼主可以自学啊，如果你想做一个软件，从无到有。那你可以选择一门 ... 计算机专业前途几何 ?觉得很迷茫 Technoboy： 终于看完了 字符集和字符编码（Charset & Encoding） 声明：ITeye文章版权属于作者，受法律保护。没有作者书面许可不得转载。若作者同意转载，必须以超链接形式标明文章原始出处和作者。 © 2003-2015 ITeye.com. All rights reserved. [ 京ICP证110151号 京公网安备110105010620 ]