本地化 Web 服务器控件概述

更新:2007 年 11 月

Localize Web 服务器控件使您可以在页的特定区域中显示本地化后的文本。

本主题包括:

  • 背景

  • 代码示例

  • 类参考

  • 其他资源

背景

Localize 控件与 Literal Web 服务器控件完全相同,并与 Label Web 服务器控件相似。虽然 Label 控件可让您向显示的文本应用样式,但 Localize 控件不允许这样做。通过设置从 Literal 控件继承的 Text 属性,您可以以编程方式控制在 Localize 控件中显示的文本。

编码内容

Localize 控件支持 Mode 属性,该属性用于指定控件对您所添加的标记的处理方式。可以将 Mode 属性设置为以下值:

  • Transform 添加到控件中的任何标记都将进行转换,以适合发出请求的浏览器的协议。如果向使用 HTML 以外的其他协议的移动设备呈现内容,此设置非常有用。

  • PassThrough 添加到控件中的任何标记都将按原样呈现在浏览器中。

  • Encode 添加到控件中的任何标记都将使用 HtmlEncode 方法进行编码,该方法将把 HTML 编码转换为其文本表示形式。例如,<b> 标记将呈现为 &lt;b&gt;。当希望浏览器显示而不解释标记时,编码将很有用。编码对于安全也很有用,有助于防止在浏览器中执行恶意标记。显示来自不受信任的源的字符串时推荐使用此设置。有关更多信息,请参见如何:通过对字符串应用 HTML 编码在 Web 应用程序中防止脚本侵入

使用资源字符串对文本进行本地化

可以创建要显示在 Localize 控件的 Text 属性中的本地化字符串,方法是使用显式或隐式表达式作为该属性的值。表达式将使用资源 (.resx) 文件中定义的字符串进行计算。

在应用程序的根目录中的名为 App_GlobalResources 和 App_LocalResources 的文件夹中创建 .resx 文件。如果必须将字符串本地化为多种语言,可以创建其他 .resx 文件,并在文件名中包含区域设置信息。例如,资源文件的法语版本可命名为 ExampleLocalizedStrings.fr.resx。

有关表达式的更多信息,请参见 ASP.NET 表达式概述。有关资源文件的信息,请参见 使用资源本地化 ASP.NET 网页。有关在 Localize 控件中使用正则表达式的代码示例,请参见 Localize Web 服务器控件声明性语法

返回页首

代码示例

如何:向 ASP.NET 网页添加 Localize Web Web 服务器控件 (Visual Studio)

返回页首

类参考

下表列出了与 Localize 控件相关的类。

成员

说明

Localize

控件的主类。

返回页首

请参见

概念

ASP.NET 应用程序中的资源

ASP.NET 表达式概述

参考

Localize

其他资源

寄宿环境中的 ASP.NET 应用程序安全性