Vue d'ensemble du contrôle serveur Web Localize
Mise à jour : novembre 2007
Le contrôle serveur Web Localize permet d'afficher du texte localisé dans une zone spécifique sur votre page.
Cette rubrique contient les sections suivantes :
Contexte
Exemples de code
Référence de classe
Ressources supplémentaires
Contexte
Le contrôle Localize est identique au contrôle serveur Web Literal et similaire au contrôle serveur Web Label. Si le contrôle Label vous permet d'appliquer un style au texte affiché, le contrôle Localize en revanche ne le permet pas. Vous pouvez contrôler par programme le texte qui est affiché dans le contrôle Localize en définissant la propriété Text qui est héritée du contrôle Literal.
Codage du contenu
Le contrôle Localize prend en charge la propriété Mode qui spécifie comment le contrôle gère le balisage que vous lui ajoutez. Vous pouvez affecter à la propriété Mode les valeurs suivantes :
Transform Tout balisage que vous ajoutez au contrôle est transformé conformément au protocole du navigateur qui effectue la demande. Ce paramètre est utile si vous restituez le contenu sur des appareils mobiles qui utilisent un autre protocole que HTML.
PassThrough Tout balisage que vous ajoutez au contrôle est restitué tel quel au navigateur.
Encode Tout balisage que vous ajoutez au contrôle est codé à l'aide de la méthode HtmlEncode qui convertit le codage HTML en sa représentation textuelle. Par exemple, une balise <b> est restituée sous la forme <b>. Le codage est utile lorsque vous souhaitez que le navigateur affiche le balisage au lieu de l'interpréter. Le codage est également utile pour la sécurité et pour aider à éviter un balisage malveillant dans le navigateur. Il est recommandé si vous affichez des chaînes d'une source non approuvée. Pour plus d'informations, consultez Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML.
Localisation de texte à l'aide de chaînes de ressources
Vous pouvez créer des chaînes localisées à afficher dans la propriété Text du contrôle Localize en utilisant une expression explicite ou implicite comme valeur de la propriété. Les expressions sont évaluées à l'aide de chaînes qui sont déclarées dans les fichiers de ressources (.resx).
Créez les fichiers .resx dans des dossiers nommés App_GlobalResources et App_LocalResources à la racine de votre application. Si vous devez localiser des chaînes pour plusieurs langues, vous pouvez créer des fichiers .resx supplémentaires précisant des informations sur les paramètres régionaux dans leur nom. Par exemple, la version française de votre fichier de ressources porterait le nom ExampleLocalizedStrings.fr.resx.
Pour plus d'informations sur les expressions, consultez Vue d'ensemble des expressions ASP.NET. Pour plus d'informations sur les fichiers de ressources, consultez Localisation de pages Web ASP.NET à l'aide de ressources. Pour obtenir un exemple de code qui utilise des expressions régulières dans le contrôle Localize, consultez Syntaxe déclarative des contrôles serveur Web Localize.
Retour au début
Exemples de code
Comment : ajouter des contrôles serveur Web Localize à des pages Web ASP.NET (Visual Studio)
Retour au début
Référence de classe
Le tableau suivant répertorie les classes relatives au contrôle Localize.
Membre |
Description |
|---|---|
Classe principale du contrôle. |
Retour au début
Voir aussi
Concepts
Ressources dans les applications ASP.NET
Vue d'ensemble des expressions ASP.NET
Référence
Autres ressources
Sécurité des applications ASP.NET dans les environnements hébergés