Gewusst wie: Lokalisieren von Code

In nicht lokalisiertem Code werden hartcodierte Zeichenfolgenwerte verwendet. Zum Lokalisieren der Codezeichenfolgen werden diese durch Aufrufe von GetGlobalResourceObject ersetzt – einer Methode zum Verweisen auf lokalisierte Ressourcen.

Lokalisieren von Code

So lokalisieren Sie Code

  1. Fügen Sie einem SharePoint-Projektelement separate Ressourcendateien hinzu: eine für die Standardsprache und jeweils eine für jede lokalisierte Sprache.

    Klicken Sie hierzu im Projektmappen-Explorer mit der rechten Maustaste auf einen Projektelementknoten, zeigen Sie auf Hinzufügen, klicken Sie auf Neues Element, und wählen Sie dann Ressourcendatei aus.

    Tipp

    Fügen Sie die Ressourcendatei einem SharePoint-Projektelement hinzu, damit die Eigenschaft "Bereitstellungstyp" verfügbar ist. Diese Eigenschaft ist später in dieser Prozedur erforderlich.

  2. 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".

  3. Öffnen Sie die einzelnen Ressourcendateien, und fügen Sie ihnen lokalisierte Zeichenfolgen hinzu. Verwenden Sie in jeder Datei die gleichen Zeichenfolgen-IDs.

  4. Ändern Sie die Eigenschaft Bereitstellungstyp der einzelnen Ressourcendateien zu AppGlobalResource, damit die Bereitstellung für jede Datei im Ordner "App_GlobalResources" des Servers erfolgt.

  5. Belassen Sie die Eigenschaft Buildvorgang der einzelnen Dateien auf Eingebettete Ressource.

    Eingebettete Ressourcen werden in die DLL des Projekts kompiliert.

  6. Erstellen Sie das Projekt, um die Satelliten-DLLs für die Ressource zu erstellen.

  7. Klicken Sie im Paket-Designer auf die Registerkarte Erweitert, und fügen Sie die Satellitenassembly hinzu.

  8. Stellen Sie dem Pfad zum Speicherort im Feld Speicherort einen Kultur-ID-Ordner voran (beispielsweise "de-DE\Projektelementname.resources.dll").

  9. Sofern von der Lösung nicht bereits auf die Assembly "System.Web" verwiesen wird, fügen Sie einen entsprechenden Verweis hinzu, und fügen Sie im Code eine Direktive zu System.Web ein.

  10. Suchen Sie im Code nach allen hartcodierten Zeichenfolgen, die den Benutzern angezeigt werden (beispielsweise UI-Text, Fehler und Meldungstext). Ersetzen Sie diese durch einen Aufruf der GetGlobalResourceObject-Methode, und verwenden Sie dabei die folgende Syntax:

    HttpContext.GetGlobalResourceObject("Resource File Name", "String ID")
    
  11. Drücken Sie F5, um die Anwendung zu erstellen und auszuführen.

  12. 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

Exemplarische Vorgehensweise: Lokalisieren einer Visual Studio SharePoint-Anwendung

Lokalisieren von SharePoint-Lösungen

Gewusst wie: Lokalisieren einer Funktion

Gewusst wie: Lokalisieren von ASPX-Markup