如何:本地化沙盒解决方案中的功能属性

本主题介绍如何在沙盒解决方案中本地化功能的属性,例如其标题和说明。

上次修改时间: 2011年4月14日

适用范围: SharePoint Foundation 2010

本地化沙盒解决方案中部署的功能的属性(例如其标题和说明)的过程在某些方面与用于服务器场解决方案的过程有所不同。

备注

本主题假定您已执行了准备创建本地化的 SharePoint 解决方案中的过程,并假定可在您的开发服务器场中使用英语和西班牙语,但您可用其他语言对替换。

每个 SharePoint 功能的基本属性 (Property) 在 Features.xml 文件中定义。(在 Microsoft Visual Studio SharePoint 项目中,该文件的扩展名为 .feature,而不是 .xml。)该文件中可能定义了自定义属性 (Property),但内置属性 (Property) 被指定为 Feature 元素的属性 (Attribute)。其中一些属性 (Attribute) (如标题和说明)可以进行本地化。对它们进行本地化可确保在网站集或网站的功能库中,您的功能将具有与网站集或网站的语言相对应的标题和说明。有关 SharePoint 中功能和功能标记的详细信息,请参阅使用功能Feature.xml 文件

沙盒解决方案无法将文件部署到服务器的文件系统,但可使用部署到内容数据库的 .resx 文件中的本地化字符串。本主题中的过程介绍如何使用此方法。

创建资源文件

  1. 在"解决方案资源管理器"中,右键单击功能名称,然后选择"添加功能资源"。

  2. 在"添加资源"对话框中,选择"固定语言(固定国家/地区)",然后单击"确定"。会在"解决方案资源管理器"中将 Resource.resx 文件添加到该功能的文件夹中,并且会在 Visual Studio"资源编辑器"中打开该文件。

    编辑时,此"固定语言"文件包含将在所有网站上的功能库中使用的功能标题和说明,而您 打算为这些网站使用的语言提供字符串的本地化版本。所以,用于此文件中字符串的语言应该最有可能成为 SharePoint 用户的第二语言,您不打算为这些用户使用的语言提供字符串翻译。通常,英语会用于此用途,但也有例外情况。例如,如果您的功能主要用在以前是法国殖民地的国家/地区,则对您的用户而言,法语将成为比英语更常用的第二语言。本主题中接下来的示例将使用英语作为默认语言。

  3. 在"资源编辑器"中的第一行的"名称"列中,输入 FeatureTitle。

  4. 在"值"列中,输入适当的标题。对于接下来的示例,请使用 Localized Sandboxed Solution。

  5. 在下一行中,使用 FeatureDescription 作为"名称",使用适当的说明作为"值"。对于接下来的示例,请使用 This is a Localized Solution。

  6. 保存该文件。

  7. 按照前面的方法向功能中添加其他资源文件,但选择特定语言,而不是"固定语言(固定国家/地区)"。对于接下来的示例,请使用"西班牙语(西班牙)"。会在"解决方案资源管理器"中将 Resource.LL-CC.resx 文件(其中,LL 是语言代码,CC 是国家/地区代码)添加到功能的文件夹中,并且会在 Visual Studio"资源编辑器"中打开该文件。

  8. 使用"资源编辑器"从 Resource.resx 复制所有行,并将它们粘贴到新 Resource.LL-CC.resx 文件中。

  9. 在 Resource.LL-CC.resx 文件中,将"值"单元格替换为字符串值的翻译版本。对于接下来的示例,请对 FeatureTitle 使用 Solución aislada localizada,对 FeatureDescription 使用 Esto es una solución localizada.。

  10. 保存新文件。

  11. 对每种外语重复前面三个步骤。对于运行的示例,再为"英语(美国)"添加一个。

    备注

    当特定语言的资源文件用于您用作固定语言的同一语言时,可复制这些行,而无需更改字符串的值。在许多情形下,不必对资源文件中与默认语言相同的语言使用特定语言的文件,尤其是当文件中的唯一资源是字符串时。但资源文件还可以包含图像、图标、文件和其他类型的资源。有时候,需要固定语言资源文件才能使用与任意 特定语言的文件中的相应资源不同的图像或其他资源。

引用 Features.xml 文件中的资源文件

  1. 在"解决方案资源管理器"中,双击 .feature 文件以将其打开。

  2. 单击设计器底部的"清单"选项卡,从"功能设计器"视图切换到原始标记视图。

  3. 单击"编辑选项"旁边的 + 展开视图的"编辑选项"部分。将在可编辑文本框中打开清单模板。

  4. 将 Title="" 和 Description="" 属性添加到 Feature 元素中。

  5. 对于 Title 属性的值,请使用 $Resources:FeatureTitle。对于"说明"属性的值,请使用 $Resources:FeatureDescription。(注意,在这些值中不使用资源文件名。)

  6. 保存该文件。

    备注

    "功能设计器"中功能的标题保持不变。

测试本地化

  1. 生成解决方案并将其打包。

  2. 将解决方案包部署到用一种外语创建的网站集的解决方案库中,并激活该解决方案。

  3. 导航至"网站设置"页,打开网站集或根网站的功能库,具体取决于功能的范围是"网站"或"Web"。您应看到列出的功能及您根据网站集的语言为其提供的标题和说明。

  4. 对您为其创建特定语言的资源文件的每种外语重复最后两步。

  5. 没有 为其创建特定语言的资源文件的某些外语网站集重复部署和激活。您应看到列出的功能及您在语言固定资源文件中为其提供的标题和说明。

请参阅

概念

沙盒解决方案体系结构

其他资源

沙盒解决方案的本地化