As diretivas de página são utilizadas para definir uma série de “comportamentos” que influenciam a maneira como uma página é processada e exibida no navegador do cliente. As diretivas podem ser incluídas em qualquer local da página, mas é de praxe colocarmos as diretivas no início da página. Uma diretiva pode conter um ou mais atributos, que definem configurações relacionadas com a diretiva.

A sintaxe geral para as diretivas é a seguinte:

<%  @Diretiva Atributo1=”Valor” Atributo2=”Valor” ... Atributon=”Valor” %>

A diretiva @Page.

Esta diretiva é utilizada para definir atributos específicos para a página ASP.NET. Os atributos são utilizados pelo processador ASP.NET para definir como a página será processada, se será ou não mantida em cache, como a resposta será enviada para o cliente e assim por diante. A diretiva @Page somente pode ser utilizada em arquivos do tipo .aspx.

A seguir descrevemos os principais atributos para esta diretiva.

• AspCompact: Pode conter o valor true ou false. Se for definida em true permite que a página .aspx acesse componentes COM antigos, criados em VB, que utilizam o modelo de Single-thread Apartment – STA, para alocação de memória e execução.

Exemplo:  <% @Page AspCompact=”true” %>

• Buffer: Define se o buffer está ou não habilitado. Pode conter os valores true ou false.

Exemplo:  <% @Page Buffer=”false” %>

• ClientTarget: Pode ser utilizado para informar ao processador ASP.NET qual o navegador do cliente, uma vez que a maneira como os controles são processados é otimizada para cada tipo de navegador. Somente são válidos os valores aceitáveis pela propriedade User Agent, do objeto HttpRequest.

• Debug: Pode ser do tipo true ou false. Já utilizamos em alguns exemplos deste livro. Se for definida em true, quando a página é compilada, o processo de debug estará habilitado. Com o processo de debug habilitado, mais informações são geradas caso aconteça algum erro. Esta opção é muito útil quando a página está em desenvolvimento, devendo ser desabilitada quando a página estiver disponível para uso. O padrão é false.

Exemplo:  <% @Page Debug=”true” %>

• EnableViewState: Pode conter os valores true ou false. Se for true (o padrão), o estado será mantido para a página e para os controles da página; se for false, o estado não será mantido.

• ErrorPage: Define a URL de uma página de erro, para a qual o processamento será redirecionado caso aconteça algum erro para o qual não foi feito o devido tratamento de exceções. Para mais informações sobre o tratamento de exceções, consulte o Capítulo 5.

• Inherits: Utilizada para configuração do mecanismo de Code Behind. Para maiores detalhes consulte o tópico - Um conceito importante: “Code Behind”, neste capítulo.

• Language: Utilizada para definir a linguagem que será utilizada na página. Na prática define qual o compilador que deve ser utilizado para compilar a página. Se não utilizarmos esta diretiva, será utilizada a linguagem VB.NET.

<%@ Page Language="C#" %>

• Src: Informa o caminho para o arquivo contendo o código da classe especificada no atributo Inherits. Para maiores detalhes consulte o tópico - Um conceito importante: “Code Behind”, neste capítulo.

A diretiva @Import.

Esta diretiva é utilizada para fazer referência a um namespace. Se formos utilizar classe de um namespace, precisamos utilizar a diretiva import para fazer referência ao respectivo namespace. Por exemplo, quando utilizamos classes do namespace System.Data.OleDb, para fazer conexão com um banco de dados do Microsoft Access, precisamos utilizar a seguinte diretiva:

<%@ Import Namespace="System.Data"  %>
   <%@ Import  Namespace="System.Data.OleDb" %>

Em cada diretiva @Import somente podemos fazer referência a um namespace. Para fazermos referência a diversos namespaces devemos utilizar várias diretivas @Import.

Existe um conjunto de namespaces aos quais já é feita referência automática, ou seja, não precisamos fazer referência explícita, utilizando a diretiva @Import. Na lista a seguir temos os namespaces aos quais é feita referência, automaticamente:

• System
• System.Collections
• System.Collections.Specialized
• System.Configuration
• System.IO
• System.Text
• System.Text.RegularExpressions
• System.Web
• System.Web.Caching
• System.Web.Security
• System.Web.SessionState
• System.Web.UI
• System.Web.UI.HtmlControls
• System.Web.UI.WebControls

Outras diretivas.

Existem outras diretivas, utilizadas com menor freqüência: @Import, @Implements, @Register, @Assembly, @OutputCache e @Reference. Para maiores informações sobre estas diretivas consulte a documentação do Framework .NET no seguinte tópico: .NET Framework Reference -> ASP.NET Syntax -> Web Forms Syntax -> Directive Syntax.