设为首页 收藏本站
查看: 924|回复: 0

[经验分享] SharePoint 2010:部署.resx(资源)文件到App_GlobalResources的简单方法

[复制链接]
累计签到:6 天
连续签到:1 天
发表于 2015-9-28 13:49:48 | 显示全部楼层 |阅读模式
SharePoint 2010中的资源文件
  通常,在我们的自定义解决方案中,资源文件主要用于实现本地化。
同样在 SharePoint 2010中, 我们的定制开发过程也会涉及类似的本地化过程,因此开发人员不可避免的需要和各种特定语言的resx文件打交道。在开发SharePoint解决方案时,resx文件可以通过名为“Resources”SharePoint映射文件夹来实现。在此路径下存放的资源文件可以通过SPUtility.GetLocalizedString 方法来访问。但毕竟,我们会遇到很多和特定用户界面相关的定制化工作。而SharePoint 2010本身是基于ASP.NET 技术实现的。所以任何包含了资源引用的标记都会从App_GlobalResources文件夹下搜索.resx文件。对于SharePoint来说,该文件夹位于 intepub\wwroot\wss\<<Web应用程序目录>> 这个路径下。
这一点就给需要要使用传统ASP.NET UI资源本地化方式进行开发的SharePoint开发人员带来了额外的部署上的开销。我们需要确保一个resx文件必须同时被部署在经典的14目录App_GlobalResources下。
  有很多办法可以部署资源文件。比如:
·    编写一个事件接收器程序(event handler)来复制 resx 文件
·    自定义timer job
·    在部署用到的PowerShell 脚本中实现
·    手工复制粘贴,等等....
  但是,当我们的解决方案需要卸载,更新时该怎么办?更惨的是,如果我们的SharePoint环境还是多服务器的场环境。这时,手工部署resx 文件的工作就会变得繁琐且十分容易出错。
  SharePoint 2010类型的项目支持称为“元素(Elements)”的功能(Feature)。通过元素我们可以部署一系列的文件到指定的位置。下面,我们就看一下如何使用元素来部署resx 文件,使其能够放在 App_GlobalResources 文件夹下。这么做至少有以下几点好处:
  ·    不需要为了部署单独写自定义的代码
·    Resx 文件被统一打包到了WSP文件中
·    不需要担心升级和卸载,因为SharePoint 自动为我们处理
·    非常适合多服务器的SharePoint场环境下部署
·    无手工步骤

步骤
  ·    新建一个 空白SharePoint 2010 项目。名为 ResxDeployment
·    选择一个本地站点进行调试,部署类型选择 部署为场解决方案

DSC0000.jpg
  ·    在解决方案资源管理器里,右击 ResxDeployment 项目,添加一个 SharePoint 映射文件夹
·    在 添加 SharePoint 映射文件夹 对话框中, 选择Resources 并点确定
DSC0001.jpg
  ·    在解决方案资源管理器里,右击 ResxDeployment 项目,添加一个新建项...
·    在Resources文件下添加一些示例 resx 文件
DSC0002.jpg
  ·    在解决方案资源管理器里,右击 ResxDeployment 项目,添加一个新建项。添加一个 空元素 并将其命名。这里我们叫做 App_GlobalResources

DSC0003.jpg
  ·    在解决方案资源管理器里,点击显示所有文件图标,来查看所有的文件。打开SharePointProjectItem.spdata 文件,该文件位于 App_GlobalResources 结点下。
DSC0004.jpg
  ·    在xml文件中添加资源文件的相关信息,包括SourceTypeType 指定成AppGlobalResourceSource 指定 resx 文件的相对路径。 如下面的例子所示:



<?xml version="1.0" encoding="utf-8"?>
<ProjectItem Type="Microsoft.VisualStudio.SharePoint.GenericElement" DefaultFile="Elements.xml" SupportedTrustLevels="All" SupportedDeploymentScopes="Web, Site, WebApplication, Farm, Package" xmlns="http://schemas.microsoft.com/VisualStudio/2010/SharePointTools/SharePointProjectItemModel">
<Files>
<ProjectItemFile Source="Elements.xml" Target="App_GlobalResources\" Type="ElementManifest" />
<ProjectItemFile Source="..\Resources\Contoso.resx" Type="AppGlobalResource"/>
<ProjectItemFile Source="..\Resources\Contoso.zh-CN.resx" Type="AppGlobalResource"/>
<ProjectItemFile Source="..\Resources\Contoso.ko-KR.resx" Type="AppGlobalResource"/>
<ProjectItemFile Source="..\Resources\Contoso.en-US.resx" Type="AppGlobalResource"/>
<ProjectItemFile Source="..\Resources\Contoso.ja-JP.resx" Type="AppGlobalResource"/>
</Files>
</ProjectItem>
  ·    在解决方案资源管理器里,双击默认的Feature1,打开Feature设计器。将我们刚刚创建的元素加到右侧。使其包含到Feature中。
DSC0005.jpg
  ·    在解决方案资源管理器里,右击 ResxDeployment 项目,选择部署
·    如果一切正常,该解决方案将被部署到指定的web 应用程序。同时,通过检查,我们看到resx 文件同时部署到了 App_GlobalResources14\Resources 文件夹下面。
DSC0006.jpg
DSC0007.jpg

需要注意的要点
  资源文件被部署到了两个不同的位置。当然你也可以直接在元素的文件夹中添加resx文件。
1.    在这个例子中,我们不需要在Visual Studio里把文件从Resources 映射文件夹拷贝到 App_GlobalResources 元素文件夹。实际上只有一份resx 文件, 所以我们不需要担心同时修改多个位置的问题。
2.    每添加一个 resx 文件, SharePointProjectItem.spdata 文件中都应该做相应的更新。否则该文件不会被复制到web应用程序的App_GlobalResources 文件夹下。
3.    请为该项目对应的功能设置适当的范围(Scope)。 通常我们设置成web应用程序这一级别。
  通过以上的方法,我们就可以利用SharePoint自带的功能框架来部署resx 文件到 App_GlobalResources

  参考资料
  Easy way to deploy .resx (resource) files under App_GlobalResources folder in SharePoint 2010

运维网声明 1、欢迎大家加入本站运维交流群:群②:261659950 群⑤:202807635 群⑦870801961 群⑧679858003
2、本站所有主题由该帖子作者发表,该帖子作者与运维网享有帖子相关版权
3、所有作品的著作权均归原作者享有,请您和我们一样尊重他人的著作权等合法权益。如果您对作品感到满意,请购买正版
4、禁止制作、复制、发布和传播具有反动、淫秽、色情、暴力、凶杀等内容的信息,一经发现立即删除。若您因此触犯法律,一切后果自负,我们对此不承担任何责任
5、所有资源均系网友上传或者通过网络收集,我们仅提供一个展示、介绍、观摩学习的平台,我们不对其内容的准确性、可靠性、正当性、安全性、合法性等负责,亦不承担任何法律责任
6、所有作品仅供您个人学习、研究或欣赏,不得用于商业或者其他用途,否则,一切后果均由您自己承担,我们对此不承担任何法律责任
7、如涉及侵犯版权等问题,请您及时通知我们,我们将立即采取措施予以解决
8、联系人Email:admin@iyunv.com 网址:www.yunweiku.com

所有资源均系网友上传或者通过网络收集,我们仅提供一个展示、介绍、观摩学习的平台,我们不对其承担任何法律责任,如涉及侵犯版权等问题,请您及时通知我们,我们将立即处理,联系人Email:kefu@iyunv.com,QQ:1061981298 本贴地址:https://www.yunweiku.com/thread-120063-1-1.html 上篇帖子: project 应用服务在sharepoint server 管理中心无法启动服务! 下篇帖子: 在blog中添加attachments功能 (利用SharePoint:AttachmentUpload ) (未解决)
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

扫码加入运维网微信交流群X

扫码加入运维网微信交流群

扫描二维码加入运维网微信交流群,最新一手资源尽在官方微信交流群!快快加入我们吧...

扫描微信二维码查看详情

客服E-mail:kefu@iyunv.com 客服QQ:1061981298


QQ群⑦:运维网交流群⑦ QQ群⑧:运维网交流群⑧ k8s群:运维网kubernetes交流群


提醒:禁止发布任何违反国家法律、法规的言论与图片等内容;本站内容均来自个人观点与网络等信息,非本站认同之观点.


本站大部分资源是网友从网上搜集分享而来,其版权均归原作者及其网站所有,我们尊重他人的合法权益,如有内容侵犯您的合法权益,请及时与我们联系进行核实删除!



合作伙伴: 青云cloud

快速回复 返回顶部 返回列表