资源文件说明：resourcefiles

<%@ Register TagPrefix="Acme" Namespace="Acme" Assembly="QSTools" %>
<%@ Register TagPrefix="Acme" TagName="SourceRef" Src=http://www.webasp.net/article/5/"/quickstart/aspplus/util/SrcRef.ascx"%>

<!-- #include virtual="/quickstart/aspplus/include/header.inc" -->

<h4>使用资源文件</h4>


<div class="indent" style="font-family:Verdana; font-size:8pt;"> <b> <img align="middle" src=http://www.webasp.net/article/5/"/quickstart/images/bullet.gif">  </b><a class="toc2" href=http://www.webasp.net/article/5/"#create">创建资源</a><br> <b> <img align="middle" src=http://www.webasp.net/article/5/"/quickstart/images/bullet.gif">  </b><a class="toc2" href=http://www.webasp.net/article/5/"#useresource">使用页上的资源</a><br> <b> <img align="middle" src=http://www.webasp.net/article/5/"/quickstart/images/bullet.gif">  </b><a class="toc2" href=http://www.webasp.net/article/5/"#satellite">使用附属程序集</a><br> <b> <img align="middle" src=http://www.webasp.net/article/5/"/quickstart/images/bullet.gif">  </b><a class="toc2" href=http://www.webasp.net/article/5/"#satellitecont">对控件使用附属程序集</a><br> <b> <img align="middle" src=http://www.webasp.net/article/5/"/quickstart/images/bullet.gif">  </b><a class="toc2" href=http://www.webasp.net/article/5/"#summary">本节小结</a><br>
</div>
<p>
<hr>



<!--BEGIN SECTION--> <a name="create"> <span class="subhead">创建资源</span>
<p>

资源管理是 .NET 框架类库的一个功能，可用于从源代码中提取可本地化的元素，并将它们与字符串键一起存储为资源。 运行时，可使用 <b>ResourceManager</b> 类的一个实例将键解析为原始资源或本地化版本。 资源可存储为独立（“松散”）文件，或程序集的一部分。
<p> ASP.NET 页可使用资源文件；另外，已编译的代码隐藏控件可以使用嵌入或链接到它们的程序集中的资源。
<p>

可使用 <b>ResourceWriter</b> 类以编程方式创建资源，或使用工具 Resgen.exe 创建资源。Resgen.exe 可使用简单的“键=值”格式作为输入，或使用 .resx 格式的 XML 文件。
<div class="code"><xmp> ; ; Lines beginning with a semicolon can be used for comments. ;

[strings] greeting=Welcome ! more=Read more ... ... </xmp></div>

<b>ResourceWriter</b> 和 Resgen.exe 创建一个 .resources 文件，该文件可单独使用，也可用作程序集的一部分。 若要在程序集中包括 .resources 文件，请使用相关的编译器开关或 Al.exe 工具。 仅包含本地化资源、不包含代码的程序集称为附属程序集。



<!--BEGIN SECTION--> <br> <a name="useresource"> <br> <span class="subhead">使用页上的资源</span>
<p>

下面的示例仅实现一个 .aspx 页，该页为每个请求都被本地化。 支持的语言是英语、德语和日语。 确定语言的方法是检查 Global.asax 文件中 HTTP 标头的 <b>Content-Language</b> 字段。 该字段的内容可通过 <b>UserLanguages</b> 集合访问：
<p>

<p><Acme:TabControl runat="server">
<Tab Name="C#"> Thread.CurrentThread.CurrentCulture = new CultureInfo(Request.UserLanguages[0]);
</Tab>

<Tab Name="VB"> Thread.CurrentThread.CurrentCulture = New CultureInfo(Request.UserLanguages(0))
</Tab>

<Tab Name="JScript"> Thread.CurrentThread.CurrentCulture = new CultureInfo(Request.UserLanguages[0]);
</Tab>

</Acme:TabControl><p>

若要更改初始语言设置，可使用以不同的方式本地化的客户端，或更改浏览器上的语言设置。 例如，对于 Internet Explorer 5.x，从菜单中选择<b>工具</b>-><b>Internet 选项</b>并单击底部的<b>语言</b>按钮。 在接下来的对话框中，可以添加其他语言，并定义它们的优先级。 为简单起见，示例总是选择第一项。
<p> 页第一次加载后，用户可在下拉列表控件 <b>MyUICulture</b> 中选择其他区域性。 如果选定的区域性有效，此值将重写从 <b>UserLanguages</b> 获得的设置：

<p><Acme:TabControl runat="server">
<Tab Name="C#"> String SelectedCulture = MyUICulture.SelectedItem.Text; if(! SelectedCulture.StartsWith("Choose")) { // If another culture was selected, use that instead. Thread.CurrentThread.CurrentCulture = new CultureInfo(SelectedCulture); Thread.CurrentThread.CurrentUICulture = new CultureInfo(SelectedCulture); }
</Tab>

<Tab Name="VB"> Dim SelectedCulture As String = MyUICulture.SelectedItem.Text If Not(SelectedCulture.StartsWith("Choose")) Then ' If another culture was selected, use that instead. Thread.CurrentThread.CurrentCulture = New CultureInfo(SelectedCulture) Thread.CurrentThread.CurrentUICulture = New CultureInfo(SelectedCulture) End If
</Tab>

<Tab Name="JScript"> var SelectedCulture:String = MyUICulture.SelectedItem.Text; if(! SelectedCulture.StartsWith("Choose")) { // If another culture was selected, use that instead. Thread.CurrentThread.CurrentCulture = new CultureInfo(SelectedCulture); Thread.CurrentThread.CurrentUICulture = new CultureInfo(SelectedCulture); }
</Tab>

</Acme:TabControl><p>

<p> 同样，在 Global.asax 文件中，将用应用程序范围初始化 <b>ResourceManager</b> 实例。 这样，资源对每个应用程序仅加载一次。 因为资源是只读的，因此不会发生锁争用。
<p><Acme:TabControl runat="server">
<Tab Name="C#"> public void Application_Start() { Application["RM"] = new ResourceManager("articles", Server.MapPath("resources") + Environment.DirectorySeparatorChar, null); }
</Tab>

<Tab Name="VB"> Public Sub Application_Start() Application("RM") = New ResourceManager("articles", _ Server.MapPath("resources") + Environment.DirectorySeparatorChar, _ Nothing) End Sub
</Tab>

<Tab Name="JScript"> public function Application_Start() : void { Application["RM"] = new ResourceManager("articles", Server.MapPath("resources") + Environment.DirectorySeparatorChar, null); }
</Tab>

</Acme:TabControl><p>

<p>

于是就可以在页上轻松地使用资源管理器。 问候字符串仅本地化为：
<div class="code"><pre> <%=rm.GetString("greeting")%>
</pre></div>

<table><tr>
<td>
<Acme:SourceRef
  ViewSource="/quickstart/aspplus/samples/localize/resources/news/global_asax.src"
  Icon="/quickstart/images/genicon.gif"
  Caption="global.asax"
  runat="server" />
</td>
<td>
<Acme:LangSwitch runat="server">
  <CsTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/localize/resources/News/CS/news.aspx"
  ViewSource="/quickstart/aspplus/samples/localize/resources/News/news.src"
  Icon="/quickstart/aspplus/images/resources2.gif"
  Caption="C# news.aspx"
  runat="server" />
  </CsTemplate>
  <VbTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/localize/resources/News/VB/news.aspx"
  ViewSource="/quickstart/aspplus/samples/localize/resources/News/news.src"
  Icon="/quickstart/aspplus/images/resources2.gif"
  Caption="VB news.aspx"
  runat="server" />
  </VbTemplate>
  <JsTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/localize/resources/News/JS/news.aspx"
  ViewSource="/quickstart/aspplus/samples/localize/resources/News/news.src"
  Icon="/quickstart/aspplus/images/resources2.gif"
  Caption="JScript news.aspx"
  runat="server" />
  </JsTemplate>
</Acme:LangSwitch>
</td>
</tr></table>

<!--BEGIN SECTION--> <br> <a name="satellite"> <br> <span class="subhead">使用附属程序集</span>
<p>

查看前一节示例中的目录结构，可以发现示例的资源不是从 DLL 加载的，而是从 .resource 文件加载。 尽管这确实是一种解决方案，但还可以将代码编译为附属程序集。 根据定义，附属程序集是仅包含资源、不包含可执行代码的程序集。 有关附属程序集的更多信息，请参阅<A HREF=http://www.webasp.net/article/5/"/quickstart/howto/doc/createresources.aspx">如何 创建资源？ </A>一节。<p> .resources 文件由于不是 DLL 而不是影像复制的，因此 Web 站点在使用它们时可能会遇到锁定问题。认识到这一点，使用附属程序集的优点就变得十分明显了。 另一种方法是使用应用程序资源的并行主程序集。  主程序集包含可依靠的资源；附属程序集（每区域性一个）包含本地化资源。 主程序集安装在 \bin 目录中，而附属程序集存储在普通的 xx-XX 子目录下（请参阅<A HREF=http://www.webasp.net/article/5/"/quickstart/howto/doc/createresources.aspx">如何 创建资源？ </A>）。作为程序集，它们是影像复制的，而且不会被锁定。 若要创建程序集识别的 .asp 应用程序：
<p>

<ol>
<li>创建资源 DLL 并将其复制到 \bin 目录中。例如：<p> resgen qq.txt qq.resources<br> al /embed:qq.resources, qq.resources, y /out:qq.dll<p> “y”指示 Blob 是否应对其他程序集可见。  由于 <b>ResourceManager</b> 位于 Mscorlib 中而且是一个不同于“qq”的程序集，因此 .resources 文件必须是公共可见的。  “y”指示这是否应是公共的。<p>
<li>在页上包括以下语句。 注意，此处的程序集名称位于在 Mscorlib 中定义的 <b>System.Reflection</b> 命名空间中（编译时总要引用它）：
<p><Acme:TabControl runat="server">
<Tab Name="C#"> <% Assembly a = Assembly.Load("qq"); ResourceManager rm = new ResourceManager("qq", a); Response.Write(rm.GetString("key")); %>
</Tab>
<Tab Name="VB"> <% Dim a As Assembly = Assembly.Load("qq") Dim rm As ResourceManager = New ResourceManager("qq", a) Response.Write(rm.GetString("key")) %>
</Tab>
<Tab Name="JScript"> <% var a:Assembly = Assembly.Load("qq"); var rm:ResourceManager = new ResourceManager("qq", a); Response.Write(rm.GetString("key")); %>
</Tab>
</Acme:TabControl>
<P>
<li>将每个附属资源编译到各自的程序集中，并将其放入 /bin 目录中所需的正确目录结构中：<p>

        al /embed:qq.en-us.resources,qq.en-us.resources, y /out:qq.resources.dll /c:en-US<p>

        将代码替换为正在将 <i>en-US</i> 本地化到的区域性。 记住，<b>/c:</b> 标记是区域性说明符。
</ol> 将 DLL 放置到正确的位置（上例中的 /bin 和 /bin/en-US）后，即可适当地检索资源。 注意，一切都通过程序集缓存得到影像复制，因此是可替换的，从而避免了潜在的锁定情况。
<p>

<!--BEGIN SECTION--> <br> <a name="satellitecont"> <br> <span class="subhead">对控件使用附属程序集</span>
<p>

已编译的代码隐藏控件还可使用附属程序集提供本地化内容。 从部署的角度看，这尤其是一件好事，因为附属程序集对代码可以是与版本无关的。 因此，只需将附属程序集的模块复制到服务器，即可提供对附加语言的支持，而不需要进行代码更改。<p>

下面的示例包含程序集 <b>LocalizedControls</b>（模块 LocalizedControls.dll）中的 <b>LocalizedButton</b> 控件。 编译控件在页 Showcontrols.aspx 上注册并在稍后使用：

<div class="code"><pre> <%@Register TagPrefix="Loc" namespace="LocalizedControls" %> ... <Loc:LocalizedButton runat="server" Text="ok" />
</pre></div>

<p> <b>LocalizedButton</b> 控件存储 <b>ResourceManager</b> 实例，该实例由 <b>LocalizedButton</b> 的所有实例共享。 每当呈现一个控件时，<b>Text</b> 属性的值便由本地化版本替换：

<p><Acme:TabControl runat="server">
<Tab Name="C#"> _rm = new ResourceManager("LocalizedStrings", Assembly.GetExecutingAssembly(), null, true ); ... override protected void Render(HtmlTextWriter writer) { Text = ResourceFactory.RManager.GetString(Text); base.Render(writer); }
</Tab>

<Tab Name="VB"> _rm = New ResourceManager("LocalizedStrings", _ Assembly.GetExecutingAssembly(), _ Nothing, _ True ) ... Overrides Protected Sub Render (writer As HtmlTextWriter) Text = ResourceFactory.RManager.GetString(Text) base.Render(writer) End Sub
</Tab>

<Tab Name="JScript"> _rm = new ResourceManager("LocalizedStrings", Assembly.GetExecutingAssembly(), null, true ); ... override protected function Render(writer:HtmlTextWriter) : void { Text = ResourceFactory.RManager.GetString(Text); base.Render(writer); }
</Tab>

</Acme:TabControl><p>

<b>ResourceManager</b> 实例负责将键解析为本地化资源。 如果具有正确区域性的附属程序集不可用，并且找不到相关的区域性，则使用主程序集的非特定语言资源（“en-us”<nobr>-></nobr>“en”<nobr>-></nobr>“非特定语言”）。 只需将新附属程序集的模块文件复制到适当的位置，即可提供另一种语言支持。
<p>

<table><tr>
<td>
<Acme:SourceRef
  ViewSource="/quickstart/aspplus/samples/localize/resources/Controls/controls.src"
  Icon="/quickstart/images/genicon.gif"
  Caption="Localized Controls"
  runat="server" />
</td>
<td>
<Acme:LangSwitch runat="server">
  <CsTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/localize/resources/ShowControls/CS/showcontrols.aspx"
  ViewSource="/quickstart/aspplus/samples/localize/resources/ShowControls/showcontrols.src"
  Icon="/quickstart/aspplus/images/resources1.gif"
  Caption="C# Using Localized Controls"
  runat="server" />
  </CsTemplate>
  <VbTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/localize/resources/ShowControls/VB/showcontrols.aspx"
  ViewSource="/quickstart/aspplus/samples/localize/resources/ShowControls/showcontrols.src"
  Icon="/quickstart/aspplus/images/resources1.gif"
  Caption="VB Using Localized Controls"
  runat="server" />
  </VbTemplate>
  <JsTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/localize/resources/ShowControls/JS/showcontrols.aspx"
  ViewSource="/quickstart/aspplus/samples/localize/resources/ShowControls/showcontrols.src"
  Icon="/quickstart/aspplus/images/resources1.gif"
  Caption="JScript Using Localized Controls"
  runat="server" />
  </JsTemplate>
</Acme:LangSwitch>
</td>
</tr></table>

<p>


<h4><a name="summary">本节小结</a></h4>
<ol>
<li>ASP.NET 页可使用资源类将资源中可本地化的内容分离出来，这部分内容在运行时被选定。
<li>另一个好办法是使用附属程序集而不是中间的 .resources 文件加载资源，因为这样可避免锁定问题。
<li>已编译控件可包含它们自己的资源，并将根据宿主页的 <b>UICulture</b> 来选择正确的本地化内容。
</ol>


<!-- #include virtual="/quickstart/aspplus/include/footer.inc" -->