Partager via

Comment : appliquer des thèmes ASP.NET

  • Article

Mise à jour : novembre 2007

Vous pouvez appliquer des thèmes à une page, à un site Web, ou au niveau global. La définition d'un thème au niveau du site Web applique des styles et des apparences (skins) à tous les contrôles et pages du site à moins que vous substituiez un thème pour une page individuelle. La définition d'un thème au niveau de la page applique des styles et des apparences à cette page ainsi qu'à tous ses contrôles.

Par défaut, les thèmes se substituent aux paramètres des contrôles locaux. Vous pouvez également définir un thème comme thème de feuille de style, afin que le thème s'applique uniquement aux options du contrôle qui ne sont pas explicitement définies sur le contrôle.

Pour appliquer un thème à un site Web

  1. Dans le fichier Web.config de l'application, affectez à l'élément < pages > le nom du thème (un thème global ou un thème de page), comme l'illustre l'exemple suivant :

    <configuration>
    <system.web>
        <pages theme="ThemeName" />
    </system.web>
</configuration>
    Remarque :

    Si un thème d'application possède le même nom qu'un thème d'application global, le thème de page prime.

  2. Pour définir un thème en tant que thème d'une feuille de style, et le subordonner aux paramètres de contrôle locaux, définissez l'attribut styleSheetTheme :

    <configuration>
    <system.web>
        <pages styleSheetTheme="Themename" />
    </system.web>
</configuration>

Un paramètre de thème configuré dans le fichier Web.config s'applique à toutes les pages Web ASP.NET de cette application. Les paramètres de thème du fichier Web.config respectent les conventions hiérarchiques de configuration normales. Si vous souhaitez, par exemple, appliquer un thème à un seul sous-ensemble de pages, vous pouvez placer les pages dans un dossier avec leur propre fichier Web.config ou créer un élément < location > dans le fichier Web.config racine pour spécifier un dossier. Pour plus d'informations, consultez Configuration de fichiers et de sous-répertoires spécifiques.

Pour appliquer un thème à une page individuelle

  • Attribuez à l'attribut Theme ou StyleSheetTheme de la directive @ Page le nom du thème à utiliser, comme illustré dans l'exemple suivant :

    <%@ Page Theme="ThemeName" %>
<%@ Page StyleSheetTheme="ThemeName" %>

    Le thème ainsi que les styles et apparences correspondants s'appliquent désormais uniquement à la page qui le déclare.

Application d'apparences aux contrôles

Les apparences définies dans votre thème s'appliquent à toutes les instances de contrôle dans l'application ou dans les pages auxquelles le thème est appliqué. Dans certains cas, vous pouvez souhaiter appliquer un jeu spécifique de propriétés à un contrôle individuel. Pour ce faire, vous créez une apparence nommée (une entrée dans un fichier .skin qui possède un jeu de propriétés SkinID), puis vous l'appliquez sur la base de son ID aux contrôles individuels.

Pour appliquer une apparence nommée à un contrôle

  • Définissez la propriété SkinID du contrôle, comme l'illustre l'exemple suivant :

    <asp:Calendar  ID="DatePicker" SkinID="SmallCalendar" />

    Si le thème de la page n'inclut aucune apparence de contrôle correspondant à la propriété SkinID, le contrôle utilise l'apparence par défaut de ce type de contrôle.

Voir aussi

Tâches

Comment : désactiver des thèmes ASP.NET

Comment : appliquer des thèmes ASP.NET par programme

Concepts

Vue d'ensemble des thèmes et des apparences ASP.NET

Autres ressources

Comment : définir des thèmes ASP.NET