Compartilhar via


@ Controle

Define o controle de usuário (arquivo .ascx)-página de atributos específicos usados pelo ASP.NET analisador e do compilador. Essa diretiva pode ser usada somente com Controles de usuário do ASP.NET (cujo código fonte está contido em arquivos .ascx).

<%@ Control attribute="value" [attribute="value" ... ] %>

Atributos

  • AutoEventWireup
    Indica se os eventos de controle são vinculada automaticamente. true Se a vinculação automática de eventos é habilitado; caso contrário, false. O padrão é true. Para obter mais informações, consulte Modelo de Eventos de Controle do Servidor Web ASP.NET.

  • ClassName
    Uma seqüência de caracteres que especifica o nome de classe do controle serão compilados dinamicamente quando o controle é solicitado. Esse valor pode ser qualquer nome de classe válido e pode incluir o espaço para nome completo de uma classe (um nome de classe totalmente qualificado). Se um valor para este atributo não for especificado, o nome de classe para o controle compilado se baseia no nome de arquivo do controle.

    Outra página ou controle pode referenciar o nome de classe atribuído ao controle usando o @ Referência diretiva.

  • CodeBehind
    Especifica o nome do arquivo compilado que contém a classe associada ao controle. Esse atributo não é usado em time de execução.

    ObservaçãoObservação:

    Esse atributo é incluído para compatibilidade com versões anteriores do ASP.NET para implementar o recurso de code-behind. No ASP.NET 2.0, em vez disso, você deve usar o CodeFile atributo para especificar o nome do arquivo de fonte, juntamente com o Inherits atributo para especificar o nome totalmente qualificado da classe.

  • CodeFile
    Especifica um caminho para o arquivo code-behind referenciado para o controle. Este atributo é usado em conjunto com o Inherits atributo para associar um code-behind arquivo de fonte com um controle de usuário. O atributo é válido somente para controles compilados.

  • CodeFileBaseClass
    Especifica um caminho para uma classe base para um controle e sua classe code-behind associado. Esse atributo é opcional, mas quando é usada a CodeFile atributo também deve estar presente. Use este atributo quando desejar implementar um cenário compartilhado, onde você define os campos comuns (e opcionalmente, associados a eventos) em uma classe base para fazer referência os controles declarados em um controle de usuário. Por causa do modelo ASP.NET código geração, se você tiver definido os campos em uma classe base sem usar esse atributo, na compilar time novas definições de membro seriam geradas para os controles declarados no controle de usuário (dentro de um stub de classe parcial separado) e seu cenário desejado não poderia trabalhar. Mas se você usar o CodeFileBaseClass atributo para associar a classe base com o controle de usuário e fazer sua classe parcial (seu nome está atribuído para o Inherits atributo e seu arquivo de fonte é citado pela CodeFile atributo) herdam da classe base, os campos na classe base será capazes de referenciar controles no controle de usuário após a geração de código.

  • CompilationMode
    Define se o controle deve ser compilado, usando uma seqüência de caracteres que especifica uma dentre várias opções enumeradas. O valor padrão é Always, para que controles .aspx são compilados por padrão. Para obter detalhes, consulte o CompilationMode enumeração.

  • CompilerOptions
    Uma seqüência de caracteres que contém opções de compilador usadas para compilar o controle. No Visual Basic e translation from VPE for Csharp, isso é uma sequência de opções de linha de comando do compilador. Para obter mais informações sobre opções do compilador, consulte Opções do Compilador C# ou Compilador do Visual Basic.

  • Debug
    Indica se o controle deve ser compilado com símbolos de depurar. true Se o controle deve ser compilada com símbolos de depurar; caso contrário, false. Porque essa configuração afeta o desempenho, você só deve conjunto o atributo para true durante o desenvolvimento.

  • Description
    Fornece uma descrição de texto do controle. Este valor é ignorado pelo analisador ASP.NET.

  • EnableTheming
    Indica se os temas são usados no controle. true Se os temas estiverem usada; caso contrário, false. O padrão é true.

  • EnableViewState
    Indica se o estado de exibição é mantido entre as solicitações de controle. true Se o estado de exibição for mantida; caso contrário, false. O padrão é true.

  • Explicit
    Determina se o controle é compilado usando o Visual Basic Option Explicit modo. true indica que a opção de compilar explícita do Visual Basic é habilitada e que todas as variáveis devem ser declaradas usando um Dim, Private, Public, ou ReDim demonstrativo; caso contrário, false. O padrão é false.

    ObservaçãoObservação:

    Esse atributo é ignorado por idiomas diferentes do Visual Basic. Além disso, essa opção é definida como true no arquivo de configuração computador.config. Para obter mais informações, consulte Arquivos de configuração do computador.

  • Inherits
    Define uma classe code-behind para o controle herdar. Isso pode ser qualquer classe derivada do UserControl classe. Usado com o CodeFile atributo, que contém o caminho para o arquivo de fonte para o código - behind classe. Para obter mais informações sobre classes code-behind, consulte Modelo de código de página Web do ASP.NET.

  • Language
    Especifica a linguagem usada durante a compilação de renderização embutido todos os (< % e < % = %>) e blocos de declaração dentro do controle de código. Valores podem representar qualquer linguagem compatível com .NET estrutura, incluindo Visual Basic, translation from VPE for Csharp ou JScript. Apenas um linguagem pode ser usado e especificado por controle.

  • LinePragmas
    Determina se o tempo de execução deve gerar pragmas de linha no código-fonte. Estas são opções de compilador que são usadas com freqüência por ferramentas de depuração para marcar locais específicos em um arquivo de fonte. true Se os pragmas de linha devem ser gerados; caso contrário, false.

  • Src
    Especifica um caminho para um arquivo de fonte que contém o código que é vinculado ao controle. No vinculado arquivo de origem, você pode optar por incluir lógica de programação para o seu controle em uma classe ou em declaração de blocos de código.

    Você pode usar o Src atributo vincular criar provedores para o controle. Para mais informações, consulte a classe BuildProvider. Além disso, em versões do ASP.NET anteriores à versão 2.0, a Src atributo foi usado sistema autônomo uma maneira alternativa para vincular um arquivo code-behind para um controle. No ASP.NET 2.0, a melhor abordagem para vincular um arquivo de fonte de code-behind para um controle é usar o Inherits atributo para especificar uma classe, juntamente com o CodeFile atributo para especificar o caminho para o arquivo de fonte para a classe.

  • Strict
    Indicates that the control should be compiled using the Visual Basic Option Strict mode. true Se Option Strict é ativado; caso contrário, false. O padrão é false.

    ObservaçãoObservação:

    Esse atributo é ignorado por idiomas diferentes do Visual Basic.

  • TargetSchema
    Especifica o nome de um esquema que valida o conteúdo do controle. Isso serve apenas uma finalidade descritiva; nenhuma validação real é realizada e o atributo é ignorado pelo analisador.

  • WarningLevel
    Indica o nível de aviso do compilador no qual você deseja que o compilador para tratar avisos sistema autônomo erros, anulando, assim, a compilação do controle. Níveis de aviso possíveis são 0 a 4. Para obter mais informações, consulte a propriedade WarningLevel.

Comentários

Essa diretiva pode ser usada somente em controles de usuário. Controles de usuário são definidos em arquivos com extensão .ascx. You can include only one @ Control directive per .ascx file. Further, you can define only one Language attribute per @ Control directive, because only one language can be used per control.

ObservaçãoObservação:

O @ Control directive has a number of attributes in common with other directives that apply to an entire source file, such as the @ Page directive (used in .aspx files for Web pages) and the @ Master directive (used in .master files for master pages).

To define multiple attributes for the @ Control directive, separate each attribute/value pair with a single space. Para um atributo específico, não inclua um espaço em ambos os lados do sinal de igual (=) que conecta o atributo com o seu valor. Para obter um exemplo, consulte a seção de exemplo deste tópico.

Exemplo

O exemplo de código a seguir instrui o compilador de página ASP.NET para usar o Visual Basic sistema autônomo o linguagem de código embutido e desativa salvando o estado de exibição em solicitações HTTP usando o EnableViewState atributo.

<%@ Control Language="VB" EnableViewState="false" %>

Consulte também

Referência

Sintaxe diretiva 

@ Page

Outros recursos

Sintaxe da página ASP.NET

Controles de usuário do ASP.NET