5,316,172 members and growing! (18,504 online)
Email Password   helpLost your password?
General Programming » Localisation » Localization     Intermediate License: The Code Project Open License (CPOL)

Developing an ASP.NET page with MasterPage and Localization

By Michael Ulmann

The MasterPage is derived from UserControl and thus, does not support the method 'InitializeCulture()'; a bit more coding is required in order to make the ASP.NET MasterPage localizable.
C# 2.0, C# 3.0, C#, Windows, .NET, .NET 3.0, .NET 2.0, ASP.NET, VS2005, Visual Studio, Dev, Design

Posted: 11 May 2007
Updated: 7 May 2008
Views: 24,593
Announcements
Want a new Job?



Search    
Advanced Search
Sitemap
26 votes for this Article.
Popularity: 6.06 Rating: 4.28 out of 5
2 votes, 7.7%
1
2 votes, 7.7%
2
0 votes, 0.0%
3
4 votes, 15.4%
4
18 votes, 69.2%
5

Introduction

While seeking on the internet for a solution to implement localization within an ASP.NET application using a MasterPage, I realized that a lot of people have got the same problem to solve. Unfortunately, I could not find a suitable solution thus, I intended to do my own implementation.

Background

The solution presented within this article uses the standard localization mechanism of the .NET framework.

Using the code

The published solution uses the Session object as storage for the currently selected culture. This will be initialized during the Session_Start method that is part of the global.asax file.

If a culture change is requested by the user, the MasterPage changes the stored culture in the Session object.

In a BasePage that inherits from Page, the method InitializeCulture is overridden and sets the appropriate culture information stored in the Session object to the current thread. Therefore, every Web Form needs to derive from this BasePage.

Let's start with the Global.asax file:

void Session_Start(object sender, EventArgs e) 
{
    //set english as default startup language
    Session["MyCulture"] = "en-GB";
}

Alternatively, the culture can be defined in the Web.config file with the key <globalization culture="en-GB" /> and then be processed and stored in the Session object from the Session_Start method.

The next step is the master page:

<%@ Master Language="C#" AutoEventWireup="true" 
           CodeFile="MasterPage.master.cs" Inherits="MasterPage" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
         "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>[Smart-Soft - Masterpage with Localization Support]</title>
</head>

<body>
    <form id="theForm" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder" runat="server">
        </asp:contentplaceholder>
    </div>
    <div style="margin-top:20px;">
        <asp:LinkButton ID="btnSetGerman" runat="server" Text="Deutsch" 
           CommandArgument="de-CH" OnClick="RequestLanguageChange_Click">
        </asp:LinkButton>  
        <asp:LinkButton ID="btnSetEnglish" runat="server" Text="English" 
           CommandArgument="en-GB" OnClick="RequestLanguageChange_Click">
        </asp:LinkButton>
    </div>
    </form>
</body>
</html>

The buttons to change the culture can be either placed in the MasterPage directly, or in any embedded UserControl. In order to determine the requested language, the CommandArgument attribute of the LinkButton is used.

..And the code-behind of the master page:

public partial class MasterPage : System.Web.UI.MasterPage
{
    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void RequestLanguageChange_Click(object sender, EventArgs e)
    {
        LinkButton senderLink = sender as LinkButton;

        //store requested language as new culture in the session
        Session["MyCulture"] = senderLink.CommandArgument;

        //reload last requested page with new culture
        Server.Transfer(Request.Path);
    }
}

The requested language, passed within the CommandArgument, is processed and stored in the Session object. Afterwards, the initially requested page will be reloaded on the server side.

Last but not least, the BasePage:

/// <summary>
/// Custom base page used for all web forms.
/// </summary>
public class BasePage : Page
{
    private const string m_DefaultCulture = "en-GB";
    
    protected override void InitializeCulture()
    {
        //retrieve culture information from session
        string culture = Convert.ToString(Session["MyCulture"]);

        //check whether a culture is stored in the session
        if (!string.IsNullOrEmpty(culture)) Culture = culture;
        else Culture = m_DefaultCulture;

        //set culture to current thread
        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(culture);
        Thread.CurrentThread.CurrentUICulture = new CultureInfo(culture);

        //call base class
        base.InitializeCulture();
    }
}

As mentioned above, the InitializeCulture method is overridden, and gets the stored culture from the Session object and assigns it to the currently running thread.

Remark: In this article, only the culture was mentioned. Of course, there is also the UI culture. But it is not of any further interest in this article since the handling is absolutely identical. For more information, please see the MSDN pages. :)

For a running example, download the Zip file above.

History

  • 11 May 2007 - First version released.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Michael Ulmann


MCAD, MCPD Web Developer
Visit my Space: http://ukmichael.spaces.live.com
Company information: www.smart-soft.ch
Occupation: Software Developer
Company: Smart-Soft
Location: Australia Australia

Other popular Localisation articles:

Article Top
Sign Up to vote for this article
You must Sign In to use this message board.
FAQ FAQ Noise ToleranceSearch Search Messages 
 Layout  Per page   
 Msgs 1 to 15 of 15 (Total in Forum: 15) (Refresh)FirstPrevNext
Subject  Author Date 
GeneralReally helpful but...memberfamous1:49 29 May '08  
GeneralExcellent ArticlememberM_Menon2:17 21 May '08  
GeneralInitializing the language automaticallymemberGuillaume Hanique0:24 8 May '08  
GeneralHotmemberpaulklee18:11 5 May '08  
GeneralPerfect example for localizationmemberfristi5:13 24 Mar '08  
GeneralGreat, Nice One!membertheRexMundi3:21 12 Mar '08  
GeneralMultiple MasterPage or no MasterPage use the global.asaxmemberJcmorin4:48 24 Jan '08  
GeneralExcellentmembermerlin9815:00 9 Nov '07  
Generalgood solution for multilanguage websitememberhavan_nd18:57 7 Nov '07  
GeneralQuestion about Code (possible bug)memberUrs Enzler3:04 14 Sep '07  
GeneralRe: Question about Code (possible bug)memberuliderknecht8:29 8 Nov '07  
GeneralRe: Question about Code (possible bug)memberUrs Enzler21:17 8 Nov '07  
GeneralPerfectmemberxiangzi_camel22:17 17 Jun '07  
GeneralGood article.memberphucrobe23:36 16 May '07  
GeneralRe: Good article.memberroundass9:05 7 May '08  

General General    News News    Question Question    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

PermaLink | Privacy | Terms of Use
Last Updated: 7 May 2008
Editor: Smitha Vijayan
Copyright 2007 by Michael Ulmann
Everything else Copyright © CodeProject, 1999-2008
Web18 | Advertise on the Code Project