Dieser Artikel wurde maschinell übersetzt.
Silverlight-Lokalisierung
Tipps und Tricks für das Laden von Silverlight-Locale-Ressourcen
Matthew Delisle
Silverlight ist eine großartige Framework zum Erstellen von rich Internet Applications (RIAs), jedoch nicht noch die stabile Unterstützung für Lokalisierung, die Sie in anderen Komponenten von Microsoft zu genießen.NET Framework. Silverlight verfügt RESX-Dateien, die eine einfache ResourceManager-Klasse und ein Element in der Projektdatei. Aber nach, die Sie selbst sind. Es gibt keine benutzerdefinierten Markuperweiterungen und keine Unterstützung für die DynamicResource-Klasse.
In diesem Artikel zeige ich Ihnen wie Sie alle diese Probleme zu beheben. Ich werde eine Lösung vorstellen, die einen Entwickler Ressourcensets zur Laufzeit zu laden, ein beliebiges Format zum Speichern von Ressourcen verwenden, Ressourcen ändern, ohne zu kompilieren und verzögerte Laden von Ressourcen zu demonstrieren.
Dieser Artikel ist in drei Teile aufgeteilt. Zunächst werde ich eine einfache Anwendung mit den Lokalisierungsprozess von Microsoft ausführliche entwickeln. Ich werde ein anderes Lokalisierungslösung erläutern, die einige Vorteile über den standard-Prozess hat. Schließlich wird die Lösung mit einer Erläuterung von Back-End-Komponenten, die erforderlich sind, um die Lösung zu vervollständigen rundet.
Das Standardverfahren für die Lokalisierung
Ich beginne, durch den Aufbau einer Silverlight-Anwendung, die den Lokalisierungsprozess von Microsoft beschrieben verwendet werden. Eine ausführliche Beschreibung des Prozesses steht unter MSDN.Microsoft.com/library/cc838238(VS.95).
Die Benutzeroberfläche enthält einen TextBlock und ein Bild wie im Abbildung 1.
.jpg)
Abbildung 1 der Anwendung
Der Lokalisierungsprozess von Microsoft beschrieben verwendet RESX-Dateien zum Speichern der Ressourcendaten für die. Die RESX-Dateien sind in die Hauptassembly oder eine Satellitenassembly eingebettet und nur einmal beim Start der Anwendung geladen wird. Sie können Anwendungen, die gezielt für bestimmte Sprachen durch Ändern des SupportedCultures-Elements in der Projektdatei erstellen. In dieser Beispielanwendung wird für zwei Sprachen, Englisch und Französisch lokalisiert. Nach dem Hinzufügen der zwei Ressourcendateien und zwei Bilder, die Flags darstellt, sieht die Projektstruktur wie Abbildung 2.
.jpg)
Abbildung 2 Projektstruktur nach dem Hinzufügen von RESX-Dateien
Ich umgeändert die Build-Aktion für die Bilder in Inhalt, so dass die Bilder mit einer weniger ausführliche Syntax verwiesen werden kann. Ich werde zwei Einträge für jede Datei hinzufügen. TextBlock wird über eine Eigenschaft namens Welcome verwiesen, und das Bild-Steuerelement über eine Eigenschaft mit dem Namen FlagImage verwiesen wird.
Beim Erstellen von Ressourcendateien in einer Silverlight-Anwendung ist der Default-Modifizierer für die generierte Klasse intern. Leider kann XAML interne Member nicht lesen, auch wenn sie in derselben Assembly gespeichert sind. Um dieses Problem zu lösen, müssen die generierte Klassenmodifizierer in public geändert werden. Dies kann in der Entwurfsansicht der Ressourcendatei erreicht werden. Das Zugriffsmodifizierer Dropdown-Menü können Sie den Umfang der generierten Klasse festlegen.
Nachdem Ressourcendateien bereit sind, müssen Sie die Ressourcen in XAML zu binden. Dazu erstellen Sie eine Wrapper-Klasse mit einem statischen Feld verweisen auf eine Instanz der Resource-Klasse. Die Klasse ist dies ganz einfach:
public class StringResources { private static readonly strings strings = new strings(); public strings Strings { get { return strings; } } }
<Application.Resources>
<local:StringResources x:Key="LocalizedStrings"/>
</Application.Resources>
<StackPanel Grid.ColumnSpan="2" Orientation="Horizontal" HorizontalAlignment="Center"> <TextBlock Text="{Binding Strings.Welcome, Source={StaticResource LocalizedStrings}}" FontSize="24"/> </StackPanel> <Image Grid.Row="1" Grid.ColumnSpan="2" HorizontalAlignment="Center" Source="{Binding Strings.FlagImage, Source={StaticResource LocalizedStrings}}"/>
<SupportedCultures> (fr) </SupportedCultures>
< Param Name = "Uiculture"Wert = "< % %=Thread.CurrentThread.CurrentCulture.Name >"/ >
< Globalization Culture = "auto"UiCulture = "auto" / >
Wie bereits erwähnt, hat eine Silverlight-Anwendung eine neutrale Sprache eingestellt. Die Einstellung ist erreicht, indem die Projekteigenschaften die Registerkarte Silverlight auf Assemblyinformationen. Die neutrale Sprache-Eigenschaft befindet sich im unteren Bereich des Dialogfensters, wie im Abbildung 3.
.jpg)
Abbildung 3 die neutrale Sprache festlegen
Ich empfehle die neutrale Sprache auf einen ohne Bereich festlegen. Diese Einstellung ist ein Fallback und ist nützlicher, wenn es eine Vielzahl von möglichen Gebietsschemas abdeckt. Festlegen einer neutralen Sprache Fügt ein Assemblyattribut in die Datei assemblyinfo.cs wie folgt:
[assembly: NeutralResourcesLanguageAttribute("en")]
public class SmartResourceManager : INotifyPropertyChanged { private static readonly List<SmartResourceManager> Instances = new List<SmartResourceManager>(); private static Dictionary<string, string> resourceSet; private static readonly Dictionary<string, Dictionary<string, string>> ResourceSets = new Dictionary<string, Dictionary<string, string>>(); public Dictionary<string, string> ResourceSet { get { return resourceSet; } set { resourceSet = value; // Notify all instances foreach (var obj in Instances) { obj.NotifyPropertyChanged("ResourceSet"); } } } public SmartResourceManager() { Instances.Add(this); } public event PropertyChangedEventHandler PropertyChanged; public void NotifyPropertyChanged(string property) { var evt = PropertyChanged; if (evt != null) { evt(this, new PropertyChangedEventArgs(property)); } }
public void ChangeCulture(CultureInfo culture) { if (!ResourceSets.ContainsKey(culture.Name)) { // Load the resource set } else { ResourceSet = ResourceSets[culture.Name]; Thread.CurrentThread.CurrentCulture = Thread.CurrentThread.CurrentUICulture = culture; } }
public string GetString(string key) { if (string.IsNullOrEmpty(key)) return string.Empty; if (resourceSet.ContainsKey(key)) { return resourceSet[key]; } else { return string.Empty; } } public string GetString(string key, string culture) { if (ResourceSets.ContainsKey(culture)) { if (ResourceSets[culture].ContainsKey(key)) { return ResourceSets[culture][key]; } else { return string.Empty; } } else { return string.Empty; } }
public SmartResourceManager() { if (Instances.Count == 0) { ChangeCulture(Thread.CurrentThread.CurrentUICulture); } Instances.Add(this); } public void Initialize(string neutralLanguageFile, string neutralLanguage) { lock (lockObject) { if (isInitialized) return; isInitialized = true; } if (string.IsNullOrWhiteSpace(neutralLanguageFile)) { // No neutral resources ChangeCulture(Thread.CurrentThread.CurrentUICulture); } else { LoadNeutralResources(neutralLanguageFile, neutralLanguage); } }
<StackPanel Grid.ColumnSpan="2" Orientation="Horizontal" HorizontalAlignment="Center"> <TextBlock Text="{Binding Path=ResourceSet[Welcome], Source={StaticResource SmartRM}}" FontSize="24"/> </StackPanel> <Image Grid.Row="1" Grid.ColumnSpan="2" HorizontalAlignment="Center" Source="{Binding ResourceSet[FlagImage], Source={StaticResource SmartRM}}"/>
public class LocalizeConverter : IValueConverter { public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture) { if (value == null) return string.Empty; Dictionary<string, string> resources = value as Dictionary<string, string>; if (resources == null) return string.Empty; string param = parameter.ToString(); if (!resources.ContainsKey(param)) return string.Empty; return resources[param]; } }
<StackPanel Grid.ColumnSpan="2" Orientation="Horizontal" HorizontalAlignment="Center"> <TextBlock Text="{Binding Path=ResourceSet, Source={StaticResource SmartRM}, Converter={StaticResource LocalizeConverter}, Convert-erParameter=Welcome}" FontSize="24"/> </StackPanel> <Image Grid.Row="1" Grid.ColumnSpan="2" HorizontalAlignment="Center" Source="{Binding ResourceSet, Source={StaticResource SmartRM}, Converter={StaticResource LocalizeConverter}, ConverterParameter=FlagImage}"/>
< Globalization Culture = "auto"UiCulture = "auto" >< / Globalisierung >
< Param Name = "Uiculture"Wert = "< % %=Thread.CurrentThread.CurrentCulture.Name >"/ >
(App.Current.Resources["SmartRM"] as SmartResourceManager).ChangeCulture( new CultureInfo("en"));
.jpg)
Abbildung 8 Änderung der Unternehmenskultur-Schaltflächen
Mit einigen Daten Pseudo würde die Anwendung ausführen und die entsprechende Sprache anzuzeigen. Die Lösung hier ermöglicht die dynamische Lokalisierung zur Laufzeit und ist erweiterbar sein müssen, die Ressourcen, die mithilfe einer benutzerdefinierten Logik zu laden.
Im nächste Abschnitt konzentriert sich auf die verbleibende Finanzierungslücke ausfüllen:, wo die Ressourcen gespeichert werden und wie diese abgerufen werden.
Serverseitige Komponenten
Jetzt erstellen wir eine Datenbank zum Speichern von Ressourcen und ein Windows Communication Foundation (WCF)-Dienst zum Abrufen von Ressourcen. In größeren Anwendungen Daten und der Geschäftsschicht erstellen sollen, aber in diesem Beispiel nicht ich alle Abstraktionen verwenden.
Der Grund dafür, dass ich habe mich entschieden, dass einen WCF-Dienst ist für die einfache Erstellung und Robustheit von WCF angeboten. Der Grund für die Ressourcen in einer relationalen Datenbank speichern gewählten ist für einfache Wartung und Verwaltung. Konnte eine Verwaltungsanwendung erstellt werden, würde ermöglichen, Übersetzer, die Ressourcen problemlos zu ändern.
Ich bin für diese Anwendung die SQL Server 2008 Express verwenden. Das Schema wird angezeigt, in Abbildung 9.
.jpg)
Abbildung 9 Schema für die Lokalisierung Tabellen in SQL Server 2008 Express
Ein Tag ist eine benannte Gruppe von Ressourcen. Eine StringResource ist die Entität, die eine Ressource darstellt. Die Gebietsschema-ID-Spalte steht für den Namen der Kultur, der die Ressource abgedeckt ist. Die Comment-Spalte wird aus Gründen der Kompatibilität mit der RESX-Format hinzugefügt. CreatedDate und ModifiedDate-Spalten werden für Überwachungszwecke hinzugefügt.
Ein StringResource kann mehrere Tags zugeordnet werden. Der Vorteil dabei ist, können bestimmte Gruppen (z. B. die Ressourcen für einen einzelnen Bildschirm) zu erstellen und nur die Ressourcen herunter. Der Nachteil ist, dass Sie mehrere Ressourcen mit dem gleichen LocaleId, Schlüssel und Tag zuweisen können. In diesem Fall sollten Sie einen Trigger erstellen oder Aktualisieren von Ressourcen verwalten, oder verwenden die ModifiedDate-Spalte, beim Abrufen der Ressource legt, fest um festzustellen, welche die aktuelle Ressource ist zu schreiben.
Ich werde zum Abrufen der Daten mithilfe von LINQ to SQL. Der erste Vorgang in einem Kulturnamen übernimmt und alle diese Kultur zugeordnete Ressourcen zurückgeben. Hier ist die Schnittstelle:
[ServiceContract] public interface ILocaleService { [OperationContract] Dictionary<string, string> GetResources(string cultureName); }
public class LocaleService : ILocaleService { private acmeDataContext dataContext = new acmeDataContext(); public Dictionary<string, string> GetResources(string cultureName) { return (from r in dataContext.StringResources where r.LocaleId == cultureName select r).ToDictionary(x => x.Key, x => x.Value); } }
public SmartResourceManager() { Instances.Add(this); localeClient.GetResourcesCompleted += localeClient_GetResourcesCompleted; if (Instances.Count == 0) { ChangeCulture(Thread.CurrentThread.CurrentUICulture); } }
private void localeClient_GetResourcesCompleted(object sender, LocaleService.GetResourcesCompletedEventArgs e) { if (e.Error != null) { var evt = CultureChangeError; if (evt != null) evt(this, new CultureChangeErrorEventArgs( e.UserState as CultureInfo, e.Error)); } else { if (e.Result == null) return; CultureInfo culture = e.UserState as CultureInfo; if (culture == null) return; ResourceSets.Add(culture.Name, e.Result); ResourceSet = e.Result; Thread.CurrentThread.CurrentCulture = Thread.CurrentThread.CurrentUICulture = culture; } }
public void ChangeCulture(CultureInfo culture) { if (!ResourceSets.ContainsKey(culture.Name)) { localeClient.GetResourceSetsAsync(culture.Name, culture); } else { ResourceSet = ResourceSets[culture.Name]; Thread.CurrentThread.CurrentCulture = Thread.CurrentThread.CurrentUICulture = culture; } }
public SmartResourceManager(string neutralLanguageFile, string neutralLanguage) { Instances.Add(this); localeClient.GetResourcesCompleted += localeClient_GetResourcesCompleted; if (Instances.Count == 1) { if (string.IsNullOrWhiteSpace(neutralLanguageFile)) { // No neutral resources ChangeCulture(Thread.CurrentThread.CurrentUICulture); } else { LoadNeutralResources(neutralLanguageFile, neutralLanguage); } } }
private void Application_Startup(object sender, StartupEventArgs e) { ConfigurationManager.Error += ConfigurationManager_Error; ConfigurationManager.Loaded += ConfigurationManager_Loaded; ConfigurationManager.LoadSettings(); }
private void ConfigurationManager_Error(object sender, EventArgs e) { Resources.Add("SmartRM", new SmartResourceManager()); this.RootVisual = new MainPage(); } private void ConfigurationManager_Loaded(object sender, EventArgs e) { Resources.Add("SmartRM", new SmartResourceManager( ConfigurationManager.GetSetting("neutralLanguageFile"), ConfigurationManager.GetSetting("neutralLanguage"))); this.RootVisual = new MainPage(); }
<AppSettings> <Add Key="neutralLanguageFile" Value="strings.xml"/> <Add Key="neutralLanguage" Value="en-US"/> </AppSettings>
.jpg "November 2018")
.png "Subscribe to the MSDN Flash newsletter")
Subscribe to MSDN Flash newsletter
Receive the MSDN Flash e-mail newsletter every other week, with news and information personalized to your interests and areas of focus.