自定义Web整合到Share Point（1）

最新推荐文章于 2019-11-01 12:38:07 发布

gnicky

最新推荐文章于 2019-11-01 12:38:07 发布

阅读量1.2k

点赞数

分类专栏： share point server 文章标签： web sharepoint styles server reference application

share point server 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

原文： Integrating a Custom ASP.NET Application into SharePoint (Part 1)

除了所有很酷的东西，有关SharePoint伟大的事情之一是:您可以自由地添加功能。更重要的是，SharePoint可以提供一个在此基础上建立自己的应用程序的平台。在这个系列中，我会告诉你如何建立一个自定义的ASP.NET应用程序，使它无缝集成到SharePoint。

首先要明白的是，我们将部署我们的自定义项目的位置。由于应用程序将运行在SharePoint网站中，该文件将被部署到layouts文件夹内〜12目录。并不需要创建一个新的IIS网站或虚拟目录，因为它使用SharePoint网站作为Hoster。

现在，对一定的文件目录应该放去哪里有不同的看法。我真的不觉得它重要，仅仅是个人喜好。一种选择是坚持与SharePoint使用的文件夹结构，只是放置一个自定义文件夹中包含您的自定义项目的每个目的地。通常，这涉及到你的文件放在以下目录：

Type

Destination

Reference Path

.aspx

12\TEMPLATE\LAYOUTS\<ProjectName>\

~/_layouts/<ProjectName>/Page.aspx

.ascx

12\TEMPLATE\CONTROLTEMPLATES\<ProjectName>\

~/_controltemplates/<ProjectName>/control.ascx

web.config

12\TEMPLATE\LAYOUTS\<ProjectName>\

(none)

.css

12\TEMPLATE\1033\Styles\<ProjectName>\

/_layouts/1033/styles/<ProjectName>/style.css

.js

12\TEMPLATE\LAYOUTS\1033\<ProjectName>\

/_layouts/1033/<ProjectName>/script.js

.dll

Either web app’s BIN directory or GAC

(none)

Resource DLLs

GAC

(none)

Images

12\TEMPLATE\IMAGES\<ProjectName>\

/_layouts/images/<ProjectName>/image.gif

Custom Folders

12\TEMPLATE\LAYOUTS\<ProjectName>\

~/_layouts/<ProjectName>/MyFolder/…

其他选项（和我个人的偏好），是把LAYOUTS目录中的自定义文件夹内的一切，只有把这些文件将在各自的地方需要的其他变动。例如，由于需要在web.config中引用到SafeControls条目的用户控件，它是有道理的，以保持在该文件夹中的用户控件。你也可以把他们的一切放到layouts文件夹内，但然后，你必须创建另一个的SafeControls条目。

Type

Destination

Reference Path

.aspx

12\TEMPLATE\LAYOUTS\<ProjectName>\

Page.aspx

.ascx

12\TEMPLATE\CONTROLTEMPLATES\<ProjectName>\

~/_controltemplates/<ProjectName>/control.ascx

web.config

12\TEMPLATE\LAYOUTS\<ProjectName>\

(none)

.css

12\TEMPLATE\LAYOUTS\<ProjectName>\Styles\

Styles/style.css

.js

12\TEMPLATE\LAYOUTS\<ProjectName>\Scripts\

Scripts/script.js

.dll

Either web app’s BIN directory or GAC

(none)

Resource DLLs

GAC

(none)

Images

12\TEMPLATE\LAYOUTS\<ProjectName>\Images

Images/image.gif

Custom Folders

12\TEMPLATE\LAYOUTS\<ProjectName>\

MyFolder/…

现在，解决了文件位置，让我们开始如何开发网页。在以后的文章中，我会讨论到如何利用内置的SharePoint的控制，权限和一些迷人的东西，在刚开，将集中显示在SharePoint页面。你用的方法可能和我有所不同，但对我来说，以下方法已被证明非常有效。首先，我在Visual Studio中创建一个新的web应用程序，并创建一个文件夹结构，模仿SharePoint的12目录：

为了提升速度，应该是可以建立一个SharePoint的开发模板的。

您大概注意到两个web.config文件，一个是默认的，一个是为了部署到SPS的，在SPS~12目录下的文件内容结构是非常简单的：为了演示其作用，增加了一格APPsetting变量customKey.

<?xml version="1.0"?>

<system.web/>

<addkey="customKey" value="Sample Value"/>

</appSettings>

</configuration>

接下来的部分可能是这整个过程中最重要的部分 - 建立正确的ASPX标记。由于这个页面将被集成到SharePoint的母版页MasterPage，适用相同的主页/内容页的原则。母版页包含的内容占位符定义页面内容将去，和自己定义的内容会在这些领域中的显示出来。 SharePoint母版页的内容预留地方很多，其中大部分我们不需要在应用程序自定义。那些是重要的是ContentHolder位置：

PlaceHolderAdditionalPageHead: The content area where custom scripts and styles will be referenced.
PlaceHolderPageTitle: The title of the page.
PlaceHolderPageTitleInTitleArea: The text that shows up right above the main content area.
PlaceHolderMain: The main content area.
PlaceHolderLeftNavBar: If you want to define your own QuickLaunch or left navigation, you could place it here.

这些概念作为一个ASP.NETWeb开发人员，对页面如何划分应该是非常了解的。OK.让我们来看点真实的：

 <%@ Page Language="C#" AutoEventWireup="true"CodeBehind="Home.aspx.cs"         Inherits="DevExpertise.LayoutsApp.Home, DevExpertise.LayoutsApp,                   Version=1.0.0.0,Culture=neutral, PublicKeyToken=d39eedb6cff9b1c8" %><asp:Content contentplaceholderid="PlaceHolderAdditionalPageHead" runat="server">    <linkrel="Stylesheet"type="text/css"href="Styles/style.css" />    <scriptsrc="Scripts/script.js"type="text/javascript"/></asp:Content><asp:Content ContentPlaceHolderID="PlaceHolderPageTitle" runat="Server">    Page Title- Custom Application</asp:Content><asp:Content ContentPlaceHolderID="PlaceHolderPageTitleInTitleArea" runat="server">    Title Area- Custom Application</asp:Content> <asp:Content ContentPlaceHolderID="PlaceHolderMain" runat="server">    <h1>This is a custom application!</h1>    <asp:TextBox id="txtValue" runat="server" />    <asp:Button id="btnSetValue" runat="server" Text="Click Me!" OnClick="btnSetValue_Click"/></asp:Content>

我们使用了4个区域，采用了自己定义的CSS/script,在Web开发中css&scriptis kingJ.在主区域，我们实现了与业务逻辑地交互：

由于此代码将SharePoint上下文下执行，受到Web部件和定制的Web服务相同的代码访问安全性限制。你基本上有3种选择：将程序集添加到Web应用程序的BIN目录并且在web.config中设置信任级别至少为WSS_Medium中；为您的应用程序创建一个自定义代码访问安全政策，最后一个方法就是添加到GAC目录。有大量的关于每种方法有优点和缺点的资料，您可以自己去搜索了解下。为简单起见，我加入到GAC。

下一步，我部署我的文件到SharePoint12目录。因为我在做开发/测试环境，我创建了一个的方便copy.bat脚本，使用XCOPY的文件复制到各自的目录。只要这个项目是准备部署，我会通过WSPBuilder运行我的解决方案，并会生成可部署的解决方案包（WSP）的。

当程序文件部署完成后，通过简单的URL访问就可以测试了，URL的语法如下http://server/site/_layouts/<ProjectFolder>/<PageName>.aspx

访问您的应用程序页时，URL是非常重要的，您的应用程序在URL中指定的SharePoint网站中运行。这是什么意思？好吧，如果你访问http://server/_layouts/MyProject/MyPage.aspx的网页，然后它运行在网站集的根网站中，访问SPContext.Current.Web将返回该网站。如果你访问您在http://server/sites/it/blog/_layouts/MyProject/MyPage.aspx页，那么它运行在IT网站集合中的博客网站，SPContext.Current.Web将反映这一点。为什么这很重要吗？好吧，因为应用程序的页面在Farm的~12目录，他们是全局可访问的，并不仅限于一个单一网站集合或网站。你甚至可以通过http://CentralAdminUrl/_layouts/MyProject/MyPage.aspx到您的应用程序，并将于中央管理的上下文（central Admin’s Context）下运行。现在你看到了URL的重要性？我会在以后的文章告诉你如何实施访问保障措施，以减轻某些问题，但现在您得知道，您目前的网页是大家可以任意访问的，而且可能是在不同的SiteContext中的。

作为开发测试，我会使用以下的URl访问定义的Page作测试http://server/sites/devexpertise/_layouts/DevExpertise.LayoutsApp/Home.aspx

Wow,出错了，检查之前的Content Page,没有声明Master Page的；除了在Decalration里面，也可以在后台Code完成。

<%@ Page Language="C#" AutoEventWireup="true"CodeBehind="Home.aspx.cs"

Inherits="DevExpertise.LayoutsApp.Home, DevExpertise.LayoutsApp,

Version=1.0.0.0,Culture=neutral, PublicKeyToken=d39eedb6cff9b1c8" %>

为方便所有的后续Page，我们实现一个base page：

namespace DevExpertise.LayoutsApp{

   public partial class Home :System.Web.UI.Page  {

 

        protected voidPage_Load(object sender, EventArgs e) {

        }

 

        protected voidbtnSetValue_Click(object sender, EventArgs e) {

            txtValue.Text = WebConfigurationManager.AppSettings["customKey"].ToString();

        }

   }

}

namespace DevExpertise.LayoutsApp{

public class LayoutsAppPage: Microsoft.SharePoint.WebControls.LayoutsPageBase {

protectedoverride void OnPreInit(EventArgs e){

base.OnPreInit(e);

try {

this.MasterPageFile = SPContext.Current.Web.MasterUrl; //设置完成

}

catch {}

} }}

你会发现，我继承从LayoutsPageBase类 - 这是在为我们提供了用于创建这些类型的网页的功能Microsoft.SharePoint.WebControls命名空间中定义一个公共基类。这是这第一篇文章的范围之外，但我会在一系列接触后。接下来，我继承我的定制LayoutsAppPage基类从我的每一个应用程序的页面：

这时候，我们部署后再访问下URL，效果如下：

非常漂亮，非常熟悉，呵呵？请继续关注本系列中的下一个Post，我们来看看如何确保我们的应用程序，并利用现有的SharePoint控件提供了丰富的和熟悉的用户界面。

gnicky

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
自定义Web整合到Share Point（1）

原文： Integrating a Custom ASP.NET Application into SharePoint (Part 1)除了所有很酷的东西，有关SharePoint伟大的事情之一是:您可以自由地添加功能。更重要的是，SharePoint可以提供一个在此基础上建立自己的应用程序的平台。在这个系列中，我会告诉你如何建立一个自定义的ASP.NET应用程序，使它无缝集成到ShareP
复制链接

扫一扫