ASP.NET 2.0 中的资源文件

导读：
ASP.NET 2.0 中的资源文件
由于在默认情况下，Visual Studio 2005 不使用项目来管理 ASP.NET 2.0 网站，所以将不会存在项目级别的资源文件，就像 Windows Forms 应用程序或类库 DLL 中那样。相反，您必须显式创建资源文件并将其添加到您的网站。而且，您还必须使用随 ASP.NET 2.0 引入的特殊文件夹：包含全局资源的资源文件应被添加到 App_GlobalResources 文件夹，而特定于某个文件的本地资源则应被添加到 App_LocalResources 文件夹。全局资源就是那些来自于页面及其他文件（如站点图）、可以在站点范围基础上使用的资源。支持本地资源的 ASP.NET 文件类型包含页（.aspx 文件）、母版页（.master 文件）和用户控件（.ascx 文件）。
不同于 ASP.NET 2.0 的另一点是，您不必像在开发国际化的 Windows Forms 应用程序时那样提前编译资源。相反，ASP.NET 运行时会准时将全局和本地资源文件编译到 DLL 中，就像 .aspx 文件那样。这是一种强大的功能，因为公司只需将 .resx 文件 XCOPY 到一个 Web 生产服务器上，即可为新语言添加本地化支持。
让我们在使用 Visual Studio 2005 的 ASP.NET 2.0 站点中，来完成一个创建和使用全局资源文件的示例。您可以先选择 Add New Item（添加新项）命令，然后再选择 Resource File（资源文件），来创建一个新的全局资源文件。
当您单击 Add（添加）按钮创建一个新的全局资源文件时，Visual Studio 2005 会用一个对话框对您进行提示，建议您将新的资源文件放置在 App_GlobalResources 目录内。单击 Yes（是）。如果您将其置于他处，则 ASP.NET 便不会将资源文件自动编译到 DLL 中。
在 ASP.NET 中使用资源文件与在 Windows Forms 应用程序中相同。首先创建一个资源文件，其字符串文字已本地化为默认区域性设置。在我们的示例网站中，有一个用于该目的的全局资源文件，该文件的名称为 Litware.resx，如图 4 所示。在您添加了所有采用默认区域性设置的指定字符串后，即可复制该资源文件并将其重命名，例如重命名为 Litware.fr.resx 以提供法语的本地化字符串。您还可以复制该法语资源文件并将其重命名为 Litware.fr-BE.resx，以维护已局部本地化为比利时法语的字符串。

图 4 本地化资源
在资源文件中添加和维护指定字符串非常容易，因为 Visual Studio 2005 提供了方便易用的资源编辑器，如图 5 所示。请记住，资源文件并不仅限于本地化字符串。您可以添加其他类型的资源，如图像文件、级联样式表和客户端 JavaScript 文件。

图 5 Visual Studio 2005 资源编辑器
现在，我们来创建从全局资源文件检索指定字符串的页面。这做起来非常容易，就像是在开发一个国际化的 Windows Forms 应用程序时，无需直接对 .NET 提供的 ResourceManager 类进行编程。因为 ASP.NET 和 Visual Studio 2005 可以在后台为每个全局资源文件生成一个强类型化资源类，并通过 IntelliSense 使其变为可用。
可通过一个驻留在名为 Resources（资源）的顶级命名空间内的强类型化类，来访问您添加到全局资源文件中的指定字符串。它使用一行代码，将一个本地化的字符串分配给控件的属性值：
lblApplicationName.Text = Resources.Litware.ApplicationName
除了以编程的方式访问外，ASP.NET 2.0 还引入声明性语法，您可以使用它将指定的字符串绑定到页或控件的属性。该语法涉及使用美元符号 ($)，其后紧跟资源命名空间、资源文件名和字符串名：
<%$ Resources:Litware, ApplicationName %>
例如，如果您想将名为 ApplicationName 的字符串绑定到 .aspx 页内一个标签的 Text 属性，您可以像这样编写标记：

Visual Studio 2005 还提供一个名为 Expression Builder 的方便易用的工具，如图 6 所示。该实用程序可帮助您生成将资源文件中指定字符串绑定到控件或页属性时所需的语法。在您用指定的字符串添加了一个或多个全局资源文件后，即可通过将 .aspx 页置于设计视图，并通过 Property（属性）表访问 Expressions 属性，来访问 Expression Builder。

图 6 Expression Builder
请注意，声明性资源绑定表达式不仅限于 .aspx 文件、.ascx 文件和 .master 文件。也可用于本地化 Web.sitemap 文件中定义的站点图中的字符串文字。图 7显示来自 LitwareWebApp 网站中站点图的 XML，它用于本地化该站点导航菜单中显示的链接标题。

返回页首
使用本地资源
本地资源文件包含用于站点内基于文件的单独项的资源，如页、母版页或用户控件。每个本地资源文件都必须正确命名并添加至 App_LocalResources 文件夹，以由 ASP.NET 进行编译。
本地资源文件的命名，应与它要为之提供资源的基于文件的项一致。例如，包含用于 AddCustomer.aspx 页的默认区域性资源的本地资源文件，应命名为 AddCustomer.aspx.resx。包含法语资源的本地资源文件应命名为 AddCustomer.aspx.fr.resx。
在您将指定的字符串添加到本地资源文件后，即可通过三种方式从页面或用户控件内访问它们。第一，您可以通过编程方式进行访问。第二，您可以使用显式语法，以声明的方式绑定到其上。第三，您可以使用隐式语法，以声明的方式绑定到其上。下面开始逐个探讨这些方法。
假设您已创建了一个本地资源文件，来本地化页面 AddCustomer.aspx 上显示的所有控件标题。要本地化该页提交按钮上显示的标题，您可以创建一个名为 btnSubmit.Text 的本地化字符串。在将该指定字符串添加到本地资源文件后，您即可通过以下调用 GetLocalResourceObject 方法和将返回值转换为字符串的代码来进行访问：
'*** AddCustomer.aspx.vb 内的代码btnSubmit.Text = _ Me.GetLocalResourceObject("btnSubmit.Text").ToString()
此代码不如以前显示的代码好，以前显示的代码是从使用强类型化类的全局资源访问指定的字符串。本地资源文件没有相关联的强类型化类，所以您无法从 IntelliSense 中获益，而且必须在调用 GetLocalResourceObject 时，显式地转换基于对象的返回值。
如果您要使用显式声明性绑定语法，则其使用方式与使用全局资源时大致相同。唯一不同的是您使用本地资源时，可以忽略资源文件的名称：

隐式声明性绑定语法是功能最强大的选项。首先将名为 meta:resourcekey 的特殊属性添加到控制标记，或添加到一个 ASP.NET 指令，如 Page、Master 或 Control。例如，如果您想通过 .aspx 文件中的 Button（按钮）控件来使用隐式声明性绑定语法，您可以像这样编写标记：

在您添加了 meta:resourcekey 属性后，就只剩一件事需要考虑了，即确保本地资源文件中的字符串具有正确的名称。在我的示例中，ASP.NET 会自动加载名为 btnSubmit.Text 的本地化字符串，并将其分配给名为 btnSubmit 的控件的 Text 属性。
关键在于，隐式绑定的基础是，创建的字符串应具有与 meta:resourcekey 属性定义的目标和属性的名称相匹配的名称。本示例中，由于 meta:resourcekey 是面向 btnSubmit 的，所以只需将更多指定的字符串添加到本地资源文件中，这样您不仅可以绑定到 Text，而且还可以绑定到其他几个属性值，如图 8 所示。

图 8 添加指定的字符串
请注意，Visual Studio 2005 可以在设计视图编辑器中打开页、用户控件或母版页时，在 Tools（工具）菜单中提供一个名为 Generate Local Resource（生成本地资源）的方便易用的命令。该命令可自动创建默认区域性的本地资源文件。还可在页面中添加 meta:resourcekey 属性，并在本地资源文件中创建相应的字符串值，来充当 meta:resourcekey 属性项目的目标。
最后，请注意：有一个名为 Localize（本地化）控件的 ASP.NET 2.0 新组件，可以使您本地化 .aspx 页上的任何元素。它提供一种不由其基类提供的设计时间功能：Literal（文字）控件；尤其是，Localize（本地化）控件提供了静态内容的设计时间编辑，以便您能够在页面设计模式下工作时查看默认值。

返回页首
在 DLL 项目中嵌入资源
我将暂时撇开国际化和本地化主题，先讨论一种在类库 DLL 中使用嵌入资源的新 ASP.NET 技术。该技术允许您在 DLL 中嵌入图像文件、级联样式表文件和 JavaScript 文件，并通过 DLL 在托管 Web 服务器上加以提供。
请注意，该技术需要使用一个面向 ASP.NET 2.0 网站的类库 DLL。这一新功能是由 ASP.NET 团队特别添加的，目的是为服务器端的控件创建者提供一种更好的方式，使他们可以在分配自定义控件和 Web 部件的同时分配资源文件。不必将资源文件与 DLL 一起分配，也不必确保他们被复制到托管 Web 服务器上一个可访问的路径，资源文件现在可以在 DLL 内自行分配，并可通过运行时由 ASP.NET 生成的 URL 加以提供。
LitwareWebApp 网站包含一个名为 LitwareWebComponents 的类库 DLL 项目，该项目演示了这一技术。在该项目内，有一个名为 LitwareSlogan.png 的图像文件已被作为资源嵌入。您可以通过将文件的“生成操作”更改为“嵌入的资源”，将资源嵌入到一个程序集中，如图 9 所示。

图 9 嵌入资源
要提供对 DLL 内一个嵌入的资源文件的基于 Web 的访问，您必须添加一个名为 WebResource 的程序集级别的属性。当您添加 WebResource 属性时，必须包含资源文件的限定名及其 MIME 类型。在 Visual Basic 类库 DLL 项目中，限定资源文件名包含项目名。
'*** 在 AssemblyInfo.vb 内Imports System.Web.UI
WebResource 属性允许您为 ASP.NET 运行时提供所需的元数据，以通过使用可在运行时生成的 URL，从 DLL 中检索资源文件。要从服务器端控件内的代码生成资源文件的 URL，您可以调用一个名为 GetWebResourceUrl 的方法，如图 10所示。
这是使该技术得以运行的后台情况。一个对 GetWebResourceUrl 的调用生成一个指向名为 WebResource.axd 的内置 HTTP 处理程序的 URL。这个动态生成的 URL 还包含一个查询字符串，来识别目标 DLL 的名称和嵌入的资源文件。通过加载一个名为 AssemblyResourceLoader 的自定义 HttpHandler 类，ASP.NET 运行时可以响应 WebResource.axd 的请求。
当调用 AssemblyResourceLoader 类以从 DLL 加载资源文件时，它可以读取由 WebResource 属性提供的元数据。AssemblyResourceLoader 类已被实现以从 DLL 的图像中提取请求资源文件，并将其引流回调用程序。AssemblyResourceLoader 类甚至提供缓存算法，可在它被加载到前端 Web 宿主内存后，在多个请求中重复使用同一资源文件。

返回页首
显示本地化图像
虽然使用嵌入的资源文件和 WebResource 属性会具有强大的功能，但是仍然存在一些明显的局限性。首先，您只能在面向 ASP.NET 2.0 网站的 DLL 项目内使用该技术。您无法在 ASP.NET 2.0 网站内直接使用该技术。第二，该技术实际上并不支持任何形式的本地化。如果您的网站具有诸如图形图像和级联样式表等已经本地化的资源文件，则您将不得不采用其他方法。
LitwareWebApp 网站显示一个名为 LitwareSlogan.png 的图形图像。该网站可依据当前用户更喜欢英语还是法语来显示不同版本的图像。尽管 ASP.NET 2.0 不直接支持本地化图像文件，但它也不需要过多的自定义代码来完成所需的效果。
您可以将本地化版本的图像文件添加到本地化版本的全局资源文件，并以此作为开始。例如，英语版本的 LitwareSlogan.png 已被添加到名为 Litware.resx 的全局资源文件，而法语版本的 LitwareSlogan.fr.png 则已添加到 Litware.fr.resx。这两个资源文件中的资源拥有一个相同的名称：LitwareSlogan。
当不同本地化版本的全局资源文件中含有本地化版本的图像文件时，您可以使用名为 LitwareSlogan.ashx 的自定义处理程序文件，基于用户的语言首选项来有条件地进行加载，如图 11所示。
LitwareSlogan.ashx 中定义的自定义处理程序类可使用您以前在自定义 InitializeCulture 方法中看到的类似逻辑，在从全局资源文件中检索图像文件以前，初始化当前线程的 CurrentUICulture 设置。您可能会注意到，要加载正确的资源文件，您必须初始化当前线程的 CurrentUICulture 属性，但不必初始化 CurrentCulture 属性。
在该自定义处理程序正确初始化了 CurrentUICulture 设置之后，它即可通过 Litware.resx 的强类型化资源类来访问图像文件。然后，便只需将图像文件的数位编写到 HTTP 响应流。显示本地化图像的最后步骤是，将 LitwareSlogan.ashx URL 分配到站点内任何页面上一个图像控件的 ImageUrl 属性。

返回页首
总结
ASP.NET 2.0 使国际化网站和资源变得更加容易。通过检查浏览器发送的 HTTP 标题，可在网站内轻松地初始化页面的区域性设置。而且，还可轻松地设计更加复杂的机制，使用户能够通过配置所需的语言首选项来个性化其体验。
请将您要提交给 Ted 的问题和意见发送至 instinct@microsoft.com。
Ted Pattison 身为作者兼培训人员的 Ted Pattison 最近成立了 Gorilla Training，该公司致力于提供有关 SharePoint 技术的、极具实力的开发人员培训。Ted 还在为 Microsoft Press 编写一本名为 Inside Windows SharePoint Services 3.0 的书。
本文摘自 2006 年 8 月出版的《MSDN Magazine》。
2006 Microsoft Corporation 版权所有。保留所有权利。使用规定。

=======================================================================

我的例子如下:
1:在VS2005建好Resource.resx文件.
lb1_name="name"
lb1_.value="jingqiu"
2:在.CS中
using System.Resources;
this.Label1.Text = Resources.Resource.lb1_name.ToString();
this.Label2.Text = Resources.Resource.lb1_sex.ToString();

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1326212

本文转自
http://blog.csdn.net/jingqiu5/archive/2006/10/08/1326212.aspx