Lokalisieren von SharePoint-Lösungen

Artikel
02/26/2013

Die Vorbereitung von Anwendungen für eine weltweite Verwendung wird als Lokalisierung bezeichnet.Bei der Lokalisierung werden die Ressourcen für einen bestimmten Kulturkreis übersetzt.Weitere Informationen finden Sie unter Globalisieren und Lokalisieren von Anwendungen.Dieses Thema bietet eine Übersicht über die Lokalisierung einer SharePoint-Lösung.

Für die Lokalisierung einer Lösung werden die hartcodierten Zeichenfolgen aus dem Code entfernt und in Ressourcendateien zusammengefasst.Bei einer Ressourcendatei handelt es sich um eine XML-basierte Datei mit der Erweiterung ".resx".Die Ressourcendatei enthält die übersetzten Versionen der in der Lösung verwendeten Zeichenfolgen.Weitere Informationen finden Sie unter Ressourcen in Anwendungen.

Hinweis
Fügen Sie Ressourcendateien von SharePoint-Lösungen ausschließlich Zeichenfolgenressourcen hinzu.Zwar ermöglicht der Ressourcen-Editor auch das Hinzufügen von Ressourcen, bei denen es sich nicht um Zeichenfolgen handelt, diese Ressourcen werden jedoch nicht für SharePoint bereitgestellt.

Ressourcendateien

Drei Arten von Ressourcendateien stehen zur Verfügung: Standarddateien, sprachunabhängige Dateien und sprachspezifische Dateien.

Ressourcendateityp	Description
Standardwert	Standardressourcendateien werden auch als Fallbackressource bezeichnet und enthalten lokalisierte Zeichenfolgen für die Standardkultur (beispielsweise Englisch).Sie werden verwendet, wenn keine lokalisierten Ressourcendateien für die angegebene Sprache gefunden werden.Standardressourcen besitzen keine separaten Dateien und sind in der Hauptanwendungsassembly gespeichert.
Sprachunabhängig	Eine Ressourcendatei mit lokalisierten Zeichenfolgen für eine Sprache, aber nicht für eine bestimmte Kultur.Beispiel: "fr" für Französisch.
Sprachspezifisch	Eine Ressourcendatei mit lokalisierten Zeichenfolgen für eine Sprache und eine Kultur.Beispiel: "fr-CA" für Französisch (Kanada).

Weitere Informationen finden Sie unter Hierarchische Organisation der Ressourcen für die Lokalisierung.

So Standardressourcendateien in SharePoint anzugeben projiziert die in Visual Studio entwickeln, auswählen Invariante Sprache (Invariantes Land) in der Kulturliste des Dialogfelds Ressource hinzufügen wenn Sie eine Ressourcendatei hinzufügen.

Lokalisieren von Visual Studio SharePoint-Lösungen

Beim Lokalisieren einer Lösung müssen alle den Benutzern angezeigten Textinformationen berücksichtigt werden.Informationsmeldungen, Fehlermeldungen und Benutzeroberfläche-Zeichenfolgen müssen übersetzt und die Übersetzungen in die Ressourcendateien eingefügt werden.

Jede Zeichenfolge in einer Ressourcendatei besitzt einen eindeutigen Bezeichner.Verwenden Sie in jeder Ressourcendatei den gleichen Bezeichner für die übersetzte Zeichenfolge.Wenn also "String1" der Bezeichner für die erste Zeichenfolge in der Standardressourcendatei ist, verwenden Sie diesen Bezeichner auch in den sprachspezifischen Ressourcendateien für die erste Zeichenfolge.

In Visual Studio SharePoint-Anwendungen werden in der Regel drei Bereiche lokalisiert: Funktionen, ASPX-Seitenmarkup und Code.Zur Veranschaulichung wird in den folgenden Abschnitten von einer SharePoint-Lösung ausgegangen, die ins Deutsche und ins Japanische lokalisiert werden soll.Die Standardsprache ist Englisch.

Lokalisieren von Funktionen

Zum Lokalisieren einer Funktion müssen der hartcodierte Titel und die Beschreibung der Funktion durch einen Ausdruck ersetzt werden, durch den auf den übersetzten Titel und die Zeichenfolge in der lokalisierten Ressourcendatei verwiesen wird.Diese Änderung wird in Visual Studio im Funktions-Designer vorgenommen.Weitere Informationen finden Sie unter Gewusst wie: Lokalisieren einer Funktion.

Zum Lokalisieren der englischen Funktion für Deutsch und Japanisch werden dem Projekt drei Ressourcendatei-Projektelemente hinzugefügt – jeweils eins für Englisch, Deutsch und Japanisch.Funktionsressourcendateien können nicht zum Lokalisieren von ASPX-Markup oder -Code verwendet werden. Hierfür werden separate Ressourcendateien benötigt.

Nach dem Erstellen der Funktionsressourcendateien werden ihnen die übersetzten Zeichenfolgen hinzugefügt.Der Zugriff auf die lokalisierten Zeichenfolgen erfolgt mittels eines Ausdrucks im folgenden Format:

$Resources:String ID

Funktionsressourcen in Visual Studio werden immer mit "Resources" benannt.Wenn Sie eine andere Sprache als invariante Sprache auswählen, wird eine Kultur ID dem Ressourcendateinamen hinzugefügt. Wenn Sie beispielsweise eine invariante (Standard) Funktionsressourcendatei der Sprache hinzugefügt, wird diese Resources.resx aufgerufen.Wenn Sie eine sprachspezifische Funktionsressource hinzufügen, indem Sie als Kultur die Option "Japanisch (Japan)" auswählen, wird die Datei mit "Resources.ja-JP.resx" benannt.Der Name einer Funktionsressourcendatei wird automatisch zugewiesen und kann nicht geändert werden.

Der Bereich von Funktionsressourcen ist für die Funktion, der sie hinzugefügt werden, lokal.Wenn Sie Ressourcen erstellen möchten, die von jeder Funktions- oder Elementdatei in der Lösung verwendet werden können, fügen Sie dem Projekt anstelle einer Funktionsressourcendatei eine globale Ressourcendatei hinzu.Das Projektelement Globale Ressourcendatei befindet sich im Dialogfeld Neues Element hinzufügen unter SharePoint im Ordner 2010.Das Bereitstellungsziel globaler Ressourcendateien ist der Ordner "\Resources" des SharePoint-Stammordners.

Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Lokalisieren einer Visual Studio SharePoint-Anwendung.

Lokalisieren von ASPX-Seitenmarkup

Um ASP.NET Seiten zu lokalisieren, fügen Sie dem Projekt drei Ressourcendatei-Projektelemente hinzugefügt hinzu: ein für Englisch, Deutsch und Japanisch. Wenn Sie Code nicht zusätzlich zum Markup lokalisieren möchten, können Sie Dateien der globalen Ressourcen stattdessen hinzufügen.

Geben Sie einen Namen für die Ressourcendatei der Standardsprache an.Benennen Sie die lokalisierten Ressourcendateien mit dem gleichen Namen, und fügen Sie diesem jeweils die sprachspezifische ID-ID an.Beispiel: "MyAppResources.de-DE.resx" für Deutsch und "MyAppResources.ja-JP.resx" für Japanisch.

Legen Sie die Eigenschaft Bereitstellungstyp der einzelnen Ressourcendateien auf AppGlobalResource fest.Dadurch werden die Ressourcendateien im Ordner "App_GlobalResources" bereitgestellt und stehen somit allen ASPX-Seiten und -Steuerelementen in der Lösung zur Verfügung.Der Ordner "App_GlobalResources" befindet sich unter "C:\inetpub\wwwroot\wss\VirtualDirectories\<Portnummer>\App_GlobalResources".

Hinweis
Verschieben Sie bei Verwendung nicht globaler Ressourcendateien die nicht globalen Ressourcendateien in den Projektelementordner, um die Eigenschaft "Bereitstellungstyp" und andere SharePoint-spezifische Eigenschaften zu aktivieren.

Ressourcendateien für ASPX-Markup können auch zum Lokalisieren von Code verwendet werden.Wenn Sie mithilfe der Ressourcen neben ASPX-Markup auch Code lokalisieren, belassen Sie die Einstellung der Eigenschaft "Buildvorgang" der einzelnen Dateien auf "Eingebettete Ressource", damit die Ressource in eine Satellitenassembly kompiliert wird.Wenn dagegen mit den Ressourcendateien ausschließlich Markup lokalisiert wird, können Sie optional die Einstellung für "Buildvorgang" zu "Inhalt" ändern, um zu verhindern, dass die Datei in die Hauptanwendungsassembly kompiliert wird.

Ersetzen Sie im Markup der ASPX-Seiten und -Steuerelemente alle hartcodierten Eigenschaftenzeichenfolgen durch einen Ausdruck im folgenden Format:

<asp:<class> runat="server" Text="<%$Resources:<Resource File Name>, <String ID>%>" />

Beispiel:

<asp:Button ID="btn1" runat="server" onclick="btn1_Click" Text="<%$Resources:Resource1,String7%>"></asp:Button>

Verwenden Sie für ASPX als Text einen Ausdruck im folgenden Format:

<asp:literal ID="<ID>" runat="server" Text="<%$Resources:<Resource File Name>, <String ID>%>" />

Beispiel:

<asp:literal ID="Literal1" runat="server" Text="<%$Resources:Resource1, String9%>" />

Weitere Informationen finden Sie unter Gewusst wie: Lokalisieren von ASPX-Markup und Exemplarische Vorgehensweise: Lokalisieren einer Visual Studio SharePoint-Anwendung.

Lokalisieren von Code

Neben Funktionszeichenfolgen und ASP.NET-Markup müssen auch die im Code der Lösung enthaltenen Meldungs- und Fehlerzeichenfolgen lokalisiert werden.Lokalisierte Informations- und Fehlermeldungen werden in Satellitenassemblys enthalten. Satellitenassemblys enthalten Zeichenfolgen, die Benutzern, wie Benutzeroberfläche Text- und Ausgabemeldungen wie Ausnahmen sichtbar sind.

Von Visual Studio wird das standardmäßige Hub- und Spoke-Modell von .NET Framework verwendet.Der Hub (Hauptprogrammassembly) enthält die Ressourcen für die Standardsprache.Die Spokes (Satellitenassemblys) enthalten die sprachspezifischen Ressourcen.Weitere Informationen finden Sie unter Verpacken und Bereitstellen von Ressourcen.Satellitenassemblys werden aus Ressourcendateien (RESX-Dateien) kompiliert.Wenn Sie dem Projekt und dem Lösungspaket sprachspezifische Ressourcendateien hinzufügen, werden die Ressourcendateien von Visual Studio zu Satellitenassemblys mit dem Namen "Projektname.resources.dll" kompiliert.

Beim Lokalisieren von SharePoint-Anwendungscode müssen dem Projekt genau wie bei ASPX-Markup separate Ressourcendatei-Projektelemente hinzugefügt werden. Dabei wird jeweils ein Element für die Standardsprache und ein Element für jede lokalisierte Sprache hinzugefügt.Wie jedoch zuvor bereits erwähnt: Wenn Sie bereits über Ressourcendateien zum Lokalisieren von ASPX-Markup verfügen, können Sie diese für die Lokalisierung des Codes wiederverwenden.Wenn Sie Ressourcendateien erstellen müssen, benennen Sie die Ressourcendatei für die Standardsprache mit einem beliebigen Namen, gefolgt von der Erweiterung ".resx".Benennen Sie die lokalisierten Ressourcendateien mit dem gleichen Namen, und fügen Sie diesem jeweils die sprachspezifische ID-ID an.Legen Sie die Eigenschaft "Buildvorgang" der einzelnen Ressourcendateien auf "Eingebettete Ressource" fest, um die Erstellung von Satellitenressourcenassemblys zu aktivieren.

Erstellen Sie zum Erstellen der Satellitenassemblys das Projekt, und fügen Sie die Dateien mithilfe der Registerkarte Erweitert des Paket-Designers als zusätzliche Assemblys hinzu.Stellen Sie dem Pfad zum Speicherort beim Hinzufügen der Assemblys einen Kultur-ID-Ordner voran (beispielsweise "de-DE\Projektelementname.resources.dll").Dadurch kann das Paket Dateien mit dem gleichen Namen enthalten.

Ersetzen Sie hartcodierte Zeichenfolgen im Code durch Aufrufe der GetGlobalResourceObject-Methode, und verwenden Sie dabei die folgende Syntax:

HttpContext.GetGlobalResourceObject("<Resource File Name>", "<String ID>")

Weitere Informationen finden Sie unter Gewusst wie: Lokalisieren von Code und Exemplarische Vorgehensweise: Lokalisieren einer Visual Studio SharePoint-Anwendung.

Lokalisieren von Webpartcode

Webparts enthalten eine benutzerdefinierte Funktion des Eigenschaften-Editors mit Codeattributen, von denen hartcodierte Zeichenfolgen wie "WebDisplayName", "Category" oder "WebDescription" verwendet werden.Erstellen Sie eine separate, von der Klasse des Attributs abgeleitete Klasse, um die Zeichenfolgenwerte für diese Attribute zu ersetzen.Legen Sie in diesen Klassen die Eigenschaft des Attributs fest.Die Attributeigenschaft hängt von der Basisklasse ab.So lautet beispielsweise die WebDisplayName-Attributeigenschaft "DisplayNameValue", und die WebDescription-Attributeigenschaft lautet "DescriptionValue".

Verweisen Sie in der abgeleiteten Klasse auf die Zeichenfolgen-ID aus der Ressourcendatei sowie auf das ResourceManager-Objekt, um den lokalisierten Wert für die Zeichenfolgen-ID abzurufen.Geben Sie diesen Wert an das Eigenschaften-Editor-Attribut zurück.Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Lokalisieren einer Visual Studio SharePoint-Anwendung.