Compartilhar via


Como: Aplicar temas ASP.NET

Você pode aplicar temas a uma página, um site da Web ou globalmente.Definindo um tema no nível do site da Web aplica estilos e capas a todas as páginas e controles no site, a menos que você substitua um tema para uma página individual.Se definir um tema no nível da página aplica estilos e capas a essa página e todos os seus controles.

Por padrão, temas substituem as configurações do controle local.Como alternativa, você pode definir um tema como um tema de folha de estilos para que o tema se aplique somente a controlar as configurações que não são explicitamente definidas no controle.

Para aplicar um tema a um site da Web

  1. No arquivo Web.config do aplicativo, definida o elemento <pages> com o nome do tema, ou um tema global ou um tema de página, conforme mostrado no exemplo a seguir:

    <configuration>
        <system.web>
            <pages theme="ThemeName" />
        </system.web>
    </configuration>
    
    Observação:

    Se um tema de aplicativo tem o mesmo nome de um tema de aplicativo global, o tema da página terá prioridade.

  2. Para definir um tema como uma folha de estilo de tema a ser subordinado as configurações do controle local), defina o atributo styleSheetTheme em vez disso:

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

Uma configuração tema no arquivo Web.config se aplica a todas as páginas da Web ASP.NET no aplicativo.Configurações de tema no arquivo Web.config seguem convenções de hierarquia de configuração normal.Por exemplo, para aplicar um tema à apenas um subconjunto de páginas, você pode colocar as páginas em uma pasta com seu próprio arquivo Web.config ou criar um elemento <location> no arquivo Web.config raiz para especificar uma pasta.Para obter detalhes, consulte:Configurando arquivos específicos e subpastas.

Para aplicar um tema a uma página individual

  • Defina o atributo Theme ou StyleSheetTheme da diretiva @ Page com o nome do tema a usar, como mostrado no exemplo a seguir:

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

    O tema e seus estilos correspondentes e capas agora se aplicam somente à página declarada.

Aplicando capas a controles

Capas definidas no seu tema se aplicam a todas as ocorrências do controle no aplicativo ou páginas ao qual o tema é aplicado.Em alguns casos, convém aplicar um conjunto específico de propriedades a um controle individual.Você pode fazer isto criando uma capa nomeada (uma entrada em um arquivo.skin que tenha uma propriedade SkinID definida) e depois aplicá-la pela identificação aos controles individuais.

Para aplicar uma capa nomeada a um controle

  • Defini a propriedade SkinID do controle como mostrado no seguinte exemplo:

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

    Se o tema da página não incluir uma capa de controle que corresponda a propriedade SkinID, então o controle usa a capa padrão para esse tipo de controle.

Consulte também

Tarefas

Como: desabilitar temas ASP.NET

Como: Aplicar temas ASP.NET programaticamente

Conceitos

Visão Geral de Temas e Aparências ASP.NET

Outros recursos

Como: Definir temas ASP.NET