通过使用资源文件使SharePoint用户界面本地化.doc

通过使用资源文件使SharePoint用户界面本地化byvbcti原文发表地址Localizing the SharePoint User Interface by Using Resource Files (Sanjay Arora)原文发表时间 2011-07-01 1:26 PMSharePoint本地化主要包括转换基于特定文化或语言的用户界面的文本。这种转换依赖于系统可用的资源文件。本地化解决方案，就要从代码中移除代码中的字符串，并将其抽象到资源文件中。资源文件的类型在SharePoint中，有两种类型的资源文件：配置资源，在配置站点和功能时使用，另一种是运行资源，在ASP.Net framework运行时使用。第一种类型的资源文件，SharePoint在配置过程中会充分利用到，位于下列位置之一： $SharePointRoot$TEMPLATEFEATURESResources $SharePointRoot$Resources注意使用这些资源文件的位置取决于你的解决方案所需的的共享级别。如果这些资源文件具体到某个功能，它们将被归属到特定功能目录。如果资源文件之间被多个功能共享，例如列表定义，网站定义，自定义操作，内容类型等等，这些文件将会出现在SharePoint的资源文件夹根目录下。第二种类型的资源文件，在ASP.Net运行过程中(aspx/ascx)被利用到，出现在下列位置中： $SharePointRoot$ConfigResources重点ASP.Net运行时不知道Sharepoint。因此，这些文件可以在运行时消耗掉，它们在各自的Web应用程序的虚拟目录下的App_GlobalResources路径中都是可用的。在解决方案中添加资源文件配置资源文件在SharePoint解决方案的部署过程中被复制到各个位置。那么，SharePoint解决方案是怎样确定部署过程中资源文件的目标位置的？该解决方案清单文件(manifest.xml)，定义在解决方案文件的根文件夹中，指定了这些资源文件的目标位置。manifest.xml文件引用了解决方案中所有的组件，并在目标机器中定义它们的位置。如果您用的是Visual Studio 2010，你可以通过右击解决方案的包文件夹预览清单文件，选择试图设计器，然后选择清单标签。功能特定的资源文件特定功能资源文件夹中的资源文件的配置，在manifest.xml文件中定义如下： 在Visual Studio 2010中，您可以通过右击相应的功能，然后选择添加功能资源，来添加资源文件。共享的资源文件SharePoint根目录下的资源文件夹中的资源文件配置，在manifest.xml文件中定义如下： 在Visual Studio 2010中，你可以通过右击你的解决方案项目，选择添加，然后选择SharePoint映射文件夹，把此资源文件添加到SharePoint根目录下的SharePoint根目录映射文件夹中。最后，将此资源文件添加到新建的资源文件夹中。另外，你可以添加一个空元素，并用“RootFile”部署类型在该空元素下添加一个资源文件。这个方法和前面方法的不同之处在于改变部署类型的灵活度。想了解部署类型的更多信息，请参阅部署类型枚举。运行库资源文件Web应用程序的资源文件配置在部署过程中，把您的文件资源复制到Web应用程序的IIS目录/ App_GlobalResources。它的定义如下： 在Visual Studio 2010中，你可以在一个空元素下添加此资源文件。一旦添加了此资源文件，文件的部署类型应设置为AppGlobalResource。注意如果你在SharePoint映射文件夹Resources中添加一个资源文件，部署类型就不能被编辑。要改变部署类型，您必须添加一个空元素SharePoint项目项到您的项目中，然后在下面添加资源文件。重点还有一些其它的资源文件位置是我在这篇文章中没提到的：virtual _wpresources or $SharePointRoot$CONFIGAdminResources_wpResources：这是全局程序集缓存（GAC）Web部件资源的位置。AdminResources：此位置有资源扩展管理中心的用户界面使用的本地化资源。检索本地化字符串配置资源使用SPUtility.GetLocalized字符串这种方法可以从位于SharePoint根目录或相应功能目录项下的资源文件夹下的资源文件中检索字符串值。该方法签名定义在这里：当定义一个功能时，你可以设置DefaultResourceFile属性，指定一个与使用应用程序中的所有功能的本地化资源的共享文件。设置好DefaultResourceFile属性后，SharePoint会在$SharePointRoot$Resources路径中寻找一个特定文化的资源文件。SharePoint设想该文件会以下面的模式命名.resx，其中，DefaultResourceFile是DefaultResourceFile属性值。CultureName是CultureInfo.Name属性所使用的格式。由DefaultResourceFile属性返回的字符串是该文件名的第一部分。如果从功能定义中省略DefaultResourceFile属性，DefaultResourceFile属性将返回一个空字符串。在这种情况下，Sharepoint从文件系统下的资源文件夹中名为Resources的子文件夹中为该功能检索资源也就是说，在$SharePointRoot$TEMPLATESFEATURESResources路径下。SharePoint设想该资源文件命名为.resx的模式资源。重点SharePoint在检索资源值时，它会寻找一个具有基本文件名的资源文件，该文件名后面是与当前执行线程的CurrentUICulture属性相对应的语言标识符。SharePoint期望找到完全匹配的文件。如果找不到与语言标识符完全匹配的资源文件，则默认为使用通过SPWeb.Language找到的网站的默认语言。这种行为不同于ASP.Net，ASP.Net的最初回退是基本语言，最终回退则是特定区域性语言。使用表达式生成器语法在XML标记或协作应用程序标记语言（CAML）中，使用下面的格式的值替换硬编码字符串：如果使用功能文件夹内部的特定功能配置资源文件，记得要在字符串表达式( )中省略资源文件的名称。运行库资源使用g HttpContext. GetGlobalResource对象这种方法可以从Web应用程序的虚拟目录下的App_GlobalResouces文件夹下的Resources文件夹中检索字符串值。该方法签名如这里定义的：如果使用资源时，要对除ASPX标记以外的代码本地化的话，要将