Gewusst wie: Erstellen von Ressourcendateien für ASP.NET-Websites (Visual Studio)

Artikel
10/22/2014

Aktualisiert: November 2007

Eine Ressourcendatei ist eine XML-Datei, die Zeichenfolgen und andere Ressourcen wie zum Beispiel Bilddateipfade enthalten kann. Ressourcendateien werden im Normalfall verwendet, um Zeichenfolgen zu speichern, die in der Benutzeroberfläche verwendet werden und in andere Sprachen übersetzt werden müssen. Der Grund dafür besteht darin, dass Sie für jede Sprache, in die Sie eine Webseite übersetzen möchten, eine eigene Ressourcendatei erstellen können.

Globale Ressourcendateien stehen jeder Seite und Komponente der Website zur Verfügung. Lokale Ressourcendateien sind mit einer einzelnen Webseite, Masterseite oder einem einzelnen Steuerelement verknüpft und enthalten lediglich die Ressourcen für diese Seite. Weitere Informationen finden Sie unter Übersicht über das Verwenden von Ressourcen für ASP.NET-Webseiten.

In Visual Web Developer können Sie den Verwaltete Ressourcen-Editor verwenden, um globale oder lokale Ressourcendateien zu erstellen. Zum Erstellen lokaler Ressourcendateien können Sie auch direkt von der Entwurfsansicht einer Webseite aus eine kulturell neutrale Basisressourcendatei generieren.

Manuelles Erstellen von Ressourcen

So erstellen Sie eine Ressourcendatei manuell

Stellen Sie sicher, dass die Website über einen Ordner verfügt, in dem die Ressourcendatei gespeichert werden kann, indem Sie einen der folgenden Schritte ausführen:
- Wenn Sie eine globale Ressourcendatei erstellen möchten, muss ein Ordner mit dem Namen App_GlobalResources vorhanden sein. Klicken Sie zum Erstellen des Ordners im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Website, klicken Sie dann auf Ordner hinzufügen und anschließend auf Ordner "App_GlobalResources". Jede Anwendung darf nur einen derartigen Ordner enthalten, und dieser muss sich im Stamm der Website befinden.
- Wenn Sie eine lokale Ressourcendatei erstellen möchten, muss ein Ordner mit dem Namen App_LocalResources vorhanden sein. Klicken Sie zum Erstellen des Ordners im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Website, klicken Sie dann auf Ordner hinzufügen und anschließend auf Ordner "App_LocalResources". Die Anwendung kann mehrere derartige Ordner enthalten, und die Ordner können sich auf jeder Ebene der Anwendung befinden.

Wenn Sie eine Ressourcendatei erstellen möchten, klicken Sie mit der rechten Maustaste auf den Ordner App_GlobalResources bzw. App_LocalResources, und klicken Sie dann auf Neues Element hinzufügen.

Hinweis:
Globale Ressourcendateien müssen im Ordner App_GlobalResources abgelegt werden. Wenn Sie versuchen, eine RESX-Datei außerhalb dieses Ordners zu erstellen, fordert Visual Web Developer Sie auf, die Datei innerhalb des Ordners zu erstellen.

Klicken Sie im Dialogfeld Neues Element hinzufügen unter Von Visual Studio installierte Vorlagen auf Assembly-Ressourcendatei.
Geben Sie im Feld Name den Namen der Ressourcendatei ein, und klicken Sie dann auf Hinzufügen.

Visual Web Developer öffnet die Datei im Verwaltete Ressourcen-Editor. Der Editor zeigt eine Tabelle an, in der Sie Namen (Schlüssel), Werte und optionale Kommentare eingeben können.

Geben Sie für jede Ressource, die Sie in der Anwendung benötigen, Schlüsselnamen und Werte ein, und speichern Sie anschließend die Datei.

Hinweis:
Sie sollten nicht versuchen, eine Grafik direkt in eine Ressourcendatei einzubetten, da die Steuerelemente die Ressourcenzeichenfolge nicht als gestreamte Bilddatei einlesen. Ressourcendateien stellen Grafiken dar, indem sie die URL der Grafik als Zeichenfolge speichern.

Wenn Sie Ressourcendateien für weitere Sprachen erstellen möchten, kopieren Sie die Datei im Projektmappen-Explorer oder in Windows Explorer, und benennen Sie die Datei anschließend nach einem der folgenden Schemas um:
- Für globale Ressourcendateien:
  
  name.language.resx
  
  name.language-culture.resx
- Für lokale Ressourcendateien:
  
  pageOrControlName.extension.language.resx
  
  pageOrControlName.extension.language-culture.resx
Wenn Sie beispielsweise eine globale Ressourcendatei mit dem Namen WebResources.resx für die Übersetzung in ägyptisches Arabisch erstellen, geben Sie der kopierten Datei den Namen WebResources.ar-eg.resx. Wenn Sie eine verwandte Ressourcendatei für die Übersetzung ins Spanische erstellen möchten, ohne eine Kultur anzugeben, geben Sie der kopierten Datei den Namen WebResources.es.resx. Beachten Sie, dass bei allen lokalen Ressourcendateien der Dateiname der Ressourcendatei der Name der Seite oder des Steuerelements inklusive der Dateinamenerweiterung ist, gefolgt von Sprach- und Kulturinformationen.
Öffnen Sie die kopierte Datei, und übersetzen Sie jeden Wert, wobei die Namen (Schlüssel) beibehalten werden müssen.
Wiederholen Sie die Schritte 6 und 7 für jede weitere Sprache, die Sie verwenden möchten.

Erstellen von Ressourcen aus einer Webseite

Das folgende Feature ist mit Visual Web Developer-Express nicht verfügbar.

So generieren Sie von einer ASP.NET-Webseite aus eine lokale Ressourcendatei

Öffnen Sie die Seite, für die Sie eine Ressourcendatei erstellen möchten.
Wechseln Sie zur Entwurfsansicht.
Klicken Sie im Menü Extras auf Lokale Ressource generieren.

Visual Web Developer erstellt den Ordner App_LocalResources, wenn er nicht bereits vorhanden ist. Anschließend erstellt Visual Web Developer die kulturell neutrale Basisressourcendatei für die aktuelle Seite. Diese Datei enthält für jede zu lokalisierende Steuerelementeigenschaft und Seiteneigenschaft ein Schlüssel-Wert-Paar. Abschließend fügt Visual Web Developer jedem ASP.NET-Webserversteuerelement ein meta-Attribut hinzu, um das Steuerelement für die Verwendung der impliziten Lokalisierung zu konfigurieren. Weitere Informationen zu impliziter und expliziter Lokalisierung finden Sie unter Übersicht über das Verwenden von Ressourcen für ASP.NET-Webseiten und Gewusst wie: Festlegen von Eigenschaftenwerten in Webserversteuerelementen mithilfe von Ressourcen (Visual Studio).

Geben Sie für jede Ressource, die Sie in der Anwendung benötigen, einen Wert ein, und speichern Sie anschließend die Datei.

Hinweis:
Sie sollten nicht versuchen, eine Grafik direkt in eine Ressourcendatei einzubetten, da die Steuerelemente die Ressourcenzeichenfolge nicht als gestreamte Bilddatei einlesen. Ressourcendateien stellen Grafiken dar, indem sie die URL der Grafik als Zeichenfolge speichern.

Wenn die letzten Ressourcenänderungen nicht angezeigt werden, aktualisieren Sie die Entwurfsansicht, indem Sie in die Quellansicht und anschließend wieder in die Entwurfsansicht wechseln.
Wiederholen Sie zum Erstellen von Ressourcendateien für weitere Sprachen die Schritte 6 und 7 der obigen Prozedur.

So generieren Sie eine globale Ressourcendatei in Visual Web Developer

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Website, klicken Sie auf Neues Element hinzufügen und anschließend auf Ressourcendatei.

Visual Web Developer stellt die Frage, ob Sie die Datei im Ordner App_GlobalResources ablegen möchten, und bietet an, diesen Ordner zu erstellen.
Klicken Sie auf Ja.

Geben Sie für jede Ressource, die Sie in der Anwendung benötigen, einen Wert ein, und speichern Sie anschließend die Datei.

Hinweis:
Sie sollten nicht versuchen, eine Grafik direkt in eine Ressourcendatei einzubetten, da die Steuerelemente die Ressourcenzeichenfolge nicht als gestreamte Bilddatei einlesen. Ressourcendateien stellen Grafiken dar, indem sie die URL der Grafik als Zeichenfolge speichern.

Wenn die letzten Ressourcenänderungen nicht angezeigt werden, aktualisieren Sie die Entwurfsansicht, indem Sie in die Quellansicht und anschließend wieder in die Entwurfsansicht wechseln.

Wenn Sie Ressourcendateien für weitere Sprachen erstellen möchten, kopieren Sie die Datei im Projektmappen-Explorer oder in Windows Explorer, und benennen Sie die Datei anschließend nach einem der folgenden Schemas um:

name.language.resx

name.language-culture.resx

Hinweis:
Achten Sie beim Benennen von Ressourcendateien darauf, dass Sie .aspx nicht zum Namen hinzufügen, da dies zu einem Benennungskonflikt führen kann. Beispielsweise kann der Ordner Resource nicht zwei Dateien mit dem Namen resTestPage.resx und resTestPage.aspx.resx enthalten. In diesem Fall würde die Auflösung der Dateinamen bei der Kompilierung zu einem Benennungskonflikt führen und einen Kompilierungsfehler auslösen.

Achten Sie beim Benennen von Ressourcendateien darauf, dass Sie .aspx nicht zum Namen hinzufügen, da dies zu einem Benennungskonflikt führen kann. Beispielsweise kann der Ordner Resource nicht zwei Dateien mit dem Namen resTestPage.resx und resTestPage.aspx.resx enthalten. In diesem Fall würde die Auflösung der Dateinamen bei der Kompilierung zu einem Benennungskonflikt führen und einen Kompilierungsfehler auslösen.