Gewusst wie: Lokalisieren von ASPX-Markup

Von ASP.NET-Seiten (ASPX-Dateien) werden üblicherweise hartcodierte Zeichenfolgenwerte verwendet. Zum Lokalisieren dieser Zeichenfolgen werden sie durch Ausdrücke ersetzt, die auf lokalisierte Ressourcen verweisen.

Lokalisieren von ASPX-Markup

So lokalisieren Sie ASPX-Markup

Fügen Sie separate Ressourcendateien hinzu: eine für die Standardsprache und jeweils eine für jede lokalisierte Sprache.

Wenn Sie nur Markup und keinen Code lokalisieren möchten, fügen Sie ein Projektelement vom Typ "Globale Ressourcendatei" hinzu. Wenn Sie Code und Markup lokalisieren möchten, fügen Sie ein Projektelement vom Typ "Ressourcendatei" hinzu.
1. Klicken Sie zum Hinzufügen einer globalen Ressourcendatei im Projektmappen-Explorer mit der rechten Maustaste auf ein SharePoint-Projektelement, zeigen Sie auf Hinzufügen, klicken Sie auf Neues Element, und wählen Sie anschließend im Ordner SharePoint 2010 die Option Globale Ressourcendatei aus.
2. Klicken Sie zum Hinzufügen einer Ressourcendatei im Projektmappen-Explorer mit der rechten Maustaste auf ein SharePoint-Projektelement, zeigen Sie auf Hinzufügen, klicken Sie auf Neues Element, und wählen Sie anschließend im Ordner Visual Basic oder Visual C# die Option Ressourcendatei aus.
Tipp

Fügen Sie einem SharePoint-Projektelement die Ressourcendateien hinzuzufügen, um die Eigenschaft "Bereitstellungstyp" zu aktivieren. Diese Eigenschaft ist später in dieser Prozedur erforderlich. Wenn die Projektmappe kein SharePoint-Projektelement enthält, können Sie ein leeres SharePoint-Projekt hinzufügen und die Standarddatei "Elements.xml" entfernen.
Benennen Sie die Ressourcendatei für die Standardsprache mit einem beliebigen Namen, und versehen Sie diesen mit der Erweiterung ".resx" (also beispielsweise "MyAppResources.resx"). Verwenden Sie für jede lokalisierte Ressourcendatei den gleichen Basisnamen, aber fügen Sie jeweils die Kultur-ID hinzu. Benennen Sie also beispielsweise eine für Deutsch lokalisierte Ressource mit "MyAppResources.de-DE.resx".
Ändern Sie die Eigenschaft Bereitstellungstyp der einzelnen Ressourcendateien zu AppGlobalResource, damit die Bereitstellung im Ordner "App_GlobalResources" des Servers erfolgt.
Wenn Sie mithilfe der Ressourcen sowohl ASPX-Markup als auch Code lokalisieren, belassen Sie die Eigenschaft Buildvorgang der einzelnen Dateien auf Eingebettete Ressource. Wenn Sie mithilfe der Ressourcendateien ausschließlich Markup lokalisieren, können Sie den Eigenschaftswert der Dateien optional zu Inhalt ändern. Weitere Informationen finden Sie unter Lokalisieren von SharePoint-Lösungen.
Öffnen Sie die einzelnen Ressourcendateien, und fügen Sie lokalisierte Zeichenfolgen hinzu. Verwenden Sie dabei in jeder Datei die gleichen Zeichenfolgen-IDs.

Ersetzen Sie im XML-Markup für die ASPX-Seite oder für das ASPX-Steuerelement die hartcodierten Zeichenfolgen durch Werte im folgenden Format:

<%$Resources:Resource File Name, String ID%>

Wenn Sie also beispielsweise den Text für ein Label-Steuerelement auf einer Anwendungsseite lokalisieren möchten, ändern Sie Folgendes:

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<asp:Label ID="lbl" runat="server" Text="Label text"></asp:Label>
</asp:Content>

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<asp:Label ID="lbl" runat="server" Text="<%$Resources:MyAppResources,String1%>"></asp:Label>
</asp:Content>

Drücken Sie F5, um die Anwendung zu erstellen und auszuführen.
Legen Sie die Anzeigesprache in SharePoint auf eine Sprache fest, die nicht der Standardsprache entspricht.

In der Anwendung werden die lokalisierten Zeichenfolgen angezeigt. Zum Anzeigen lokalisierter Ressourcen muss auf dem SharePoint-Server ein Language Pack installiert sein, das der Kultur der Ressourcendatei entspricht.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen einer Ressourcendatei

Weitere Ressourcen

Lokalisieren von SharePoint-Lösungen

Gewusst wie: Lokalisieren einer Funktion

Gewusst wie: Lokalisieren von Code

Last updated on 2011-08-10