Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Mithilfe des Localize-Webserversteuerelements können Sie in einem bestimmten Bereich der Seite lokalisierten Text anzeigen.
Dieses Thema enthält folgende Abschnitte:
Hintergrund
Codebeispiele
Klassenreferenz
Zusätzliche Ressourcen
Hintergrund
Das Localize-Steuerelement ist mit dem Literal-Webserver-Steuerelement identisch und ähnelt dem Label-Webserver-Steuerelement. Mithilfe des Label-Steuerelements kann ein Stil auf den angezeigten Text angewendet werden; dies ist mit dem Localize-Steuerelement jedoch nicht möglich. Der im Localize-Steuerelement angezeigte Text kann durch Festlegen der vom Literal-Steuerelement geerbten Text-Eigenschaft programmgesteuert gesteuert werden.
Codierung von Inhalt
Das Localize-Steuerelement unterstützt die Mode-Eigenschaft. Diese Eigenschaft bestimmt, wie das Steuerelement Markup behandelt, das Sie dem Element hinzufügen. Sie können die Mode-Eigenschaft auf die folgenden Werte festlegen:
Transform Jedes Markup, das Sie dem Steuerelement hinzufügen, wird so umgewandelt, dass es zu dem Protokoll des anfordernden Browsers passt. Diese Einstellung bietet sich an, wenn Inhalte auf einem mobilen Gerät gerendert werden sollen, das ein anderes Protokoll als HTML verwendet.
PassThrough Jedes Markup, das Sie dem Steuerelement hinzufügen, wird ohne Änderungen auf dem Browser gerendert.
Encode Jedes Markup, das Sie dem Steuerelement hinzufügen, wird mit der HtmlEncode-Methode codiert, die HTML-Codierung in die jeweilige Textdarstellung konvertiert. Zum Beispiel wird ein <b>-Tag als <b> gerendert. Eine Codierung empfiehlt sich, wenn der Browser Markup anzeigen soll, anstatt es zu interpretieren. Die Codierung dient der Sicherheit und kann verhindern, dass böswilliges Markup im Browser ausgeführt wird. Sie wird empfohlen, wenn Zeichenfolgen aus einer nicht vertrauenswürdigen Quelle angezeigt werden. Weitere Informationen hierzu finden Sie unter Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen.
Lokalisieren von Text mit Ressourcenzeichenfolgen
Sie können lokalisierte Zeichenfolgen erstellen, die in der Text-Eigenschaft des Localize-Steuerelements angezeigt werden sollen, indem Sie als Wert der Eigenschaft einen expliziten oder impliziten Ausdruck verwenden. Ausdrücke werden durch die Verwendung von Zeichenfolgen ausgewertet, die in Ressourcendateien (.resx) deklariert werden.
Erstellen Sie die RESX-Dateien in den Ordnern App_GlobalResources und App_LocalResources im Stammverzeichnis der Anwendung. Wenn Sie Zeichenfolgen für mehrere Sprachen lokalisieren möchten, können Sie zusätzliche RESX-Dateien erstellen, deren Gebietsschemainformation im Dateinamen enthalten ist. Beispielsweise lautet die französische Version der Ressourcendatei ExampleLocalizedStrings.fr.resx.
Weitere Informationen über Ausdrücke finden Sie unter Übersicht über ASP.NET-Ausdrücke. Informationen über Ressourcendateien finden Sie unter Lokalisieren von ASP.NET-Webseiten mithilfe von Ressourcen. Ein Codebeispiel, in dem reguläre Ausdrücke im Localize-Steuerelement verwendet werden, finden Sie unter Deklarative Syntax des Localize-Webserver-Steuerelements.
Zurück nach oben
Codebeispiele
Gewusst wie: Hinzufügen von Localize-Webserver-Steuerelementen zu ASP.NET-Webseiten (Visual Studio)
Zurück nach oben
Klassenreferenz
Die folgende Tabelle enthält die Klassen, die sich auf das Localize-Steuerelement beziehen.
Member |
Beschreibung |
|---|---|
Die Hauptklasse des Steuerelements. |
Zurück nach oben
Siehe auch
Konzepte
Ressourcen in ASP.NET-Anwendungen
Übersicht über ASP.NET-Ausdrücke