As diretivas ASP.NET são instruções para especificar configurações opcionais, como registrar um controle personalizado e o idioma da página. Essas configurações descrevem como o NET Framework lida com páginas da Web de formulário de página única (.aspx) ou de controle de usuário (.ascx).
Sintaxe básica para emitir comandos:
<%@ directive_name attribute=value [attribute=value] %>Nesta seção, apresentaremos as diretivas ASP.NET, a maioria das quais será usada ao longo do tutorial.
As diretivas de aplicativos definem propriedades específicas do aplicativo. Ele é fornecido na parte superior do arquivo global.aspx.
Sintaxe básica das instruções do aplicativo:
<%@ Application Language="C#" %>Propriedades da diretiva de aplicação:
| propriedade | descrever |
|---|---|
| Herda | Herdado do nome da classe. |
| Descrição | Uma descrição de texto do aplicativo. O analisador e o compilador ignoram isso. |
| Linguagem | A linguagem usada no grupo de códigos. |
As diretivas de coleção vinculam componentes a uma página da web ou aplicativo durante a análise. Isso pode ocorrer em todo o link do tipo de aplicativo em um arquivo Global.asax, em um arquivo de página, em um controle de usuário vinculado a outra página da Web ou em um controle de usuário.
A sintaxe básica de um controle de coleção é:
<%@ Assembly Name ="myassembly" %>As propriedades do controle de coleção são:
| propriedade | descrever |
|---|---|
| Nome | O nome do componente de coleção vinculado. |
| Fonte | O caminho ao qual os arquivos de origem são vinculados e editados dinamicamente. |
As instruções de controle são usadas com controles de usuário e aparecem em arquivos de controle de usuário (.ascx).
A sintaxe básica das instruções de controle é:
<%@ Control Language="C#" EnableViewState="false" %>As propriedades das instruções de controle são:
| propriedade | descrever |
|---|---|
| AutoEventWireup | Valor booleano que permite ou desabilita a associação automática de manipuladores de eventos. |
| Nome da Classe | O nome do arquivo do controle. |
| Depurar | Valor booleano que permite ou desabilita a edição de símbolos de depuração. |
| Descrição | Descrição de texto da página de controle, ignorada pelo compilador. |
| EnableViewState | A solicitação de página é um valor booleano para manter o estado de visualização. |
| Explícito | Na linguagem VB, informa ao editor para usar o modo de exibição de opções. |
| Herda | Controle a classe herdada pela página. |
| Linguagem | Linguagens de codificação e script. |
| Fonte | O nome do arquivo da classe code-behind. |
| Estrito | Na linguagem VB, instrui o editor a utilizar a opção Modo Padrão. |
As diretivas de ferramenta indicam que uma página da web, página mestra ou página de controle de usuário deve implementar uma interface .Net Framework especificada.
A sintaxe básica das instruções da ferramenta é:
<%@ Implements Interface="interface_name" %>A diretiva import importa um namespace para uma página de um aplicativo controlado pelo usuário. Se a diretiva Import for especificada no arquivo global.asax, ela se aplicará a todo o aplicativo. Se estiver em uma página da web dentro de uma página controlada pelo usuário, será aplicado a essa página da web ou controle.
A sintaxe básica da diretiva de importação é:
<%@ namespace="System.Drawing" %>A diretiva principal especifica um arquivo de paginação como página inicial.
A sintaxe básica do exemplo de diretiva da página inicial é:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>A diretiva MasterType atribui um nome de classe ao atributo master da página, reforçando seu tipo.
A sintaxe básica da diretiva master é:
<%@ MasterType attribute="value"[attribute="value" ...] %>A diretiva de cache de saída controla a política de cache de saída de uma página da web ou controle de usuário.
Sintaxe básica para instruções de cache de saída:
<%@ OutputCache Duration="15" VaryByParam="None" %>As diretivas de página definem atributos de arquivo de página para analisadores e compiladores de páginas específicos.
A sintaxe básica da diretiva de página é:
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>As propriedades da diretiva de página são:
| propriedade | descrever |
|---|---|
| AutoEventWireup | Valor booleano que permite ou desabilita a vinculação automática de eventos de página a métodos, por exemplo, Page_Load. |
| Tampão | Valor booleano que permite ou desabilita o buffer de resposta HTTP. |
| Nome da Classe | O nome da categoria da página. |
| ClienteTarget | O controle do servidor deve renderizar o conteúdo para o navegador |
| Arquivo de código | O nome do arquivo code-behind. |
| Depurar | Valor booleano que permite ou desabilita a compilação com símbolos de depuração. |
| Descrição | A descrição do arquivo da página, ignorada pelo analisador. |
| EnableSessionState | Ativa ou desativa o status da sessão da página como somente leitura. |
| EnableViewState | Um valor booliano que permite ou não permite solicitações entre páginas para o estado de visualização. |
| Página de erro | Endereço de redirecionamento em caso de exceção de página não tratada. |
| Herda | O nome do code-behind ou outra classe. |
| Linguagem | Linguagem de programação de código. |
| Fonte | O nome do arquivo da classe code-behind. |
| Rastreamento | Ative ou desative o rastreamento. |
| Modo de rastreamento | Indica como as informações de rastreamento são exibidas e classificadas por hora ou categoria. |
| Transação | Indica se a transação é suportada. |
| Validar Solicitação | Um valor booliano que indica se todos os dados de entrada são validamente verificados como uma lista codificada permanentemente. |
A diretiva de página anterior atribui uma categoria a uma página, fazendo com que esse tipo de página seja aprimorado.
Sintaxe básica para um exemplo da diretiva de página anterior:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>A diretiva de referência indica que outra página ou controle de usuário deve ser compilado e vinculado à página atual.
A sintaxe básica da diretiva de referência é:
<%@ Reference Page ="somepage.aspx" %>A diretiva de registro é usada para registrar controles de servidor personalizados e controles de usuário.
A sintaxe básica da diretiva de registro é:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>