@ Control

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Define os atributos que são específicos para controles de usuário (arquivos. ascx) que são usados pelo processo do ASP.O analisador de página NET e do compilador. Essa diretiva pode ser usada somente com (cujo código-fonte contido em arquivos. ascx). Para obter mais informações sobre controles de usuário, consulte ASP.NET User Controls.

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

Atributos

• AutoEventWireup
  Indica se os eventos de controle devem ser conectados automaticamente. trueSe a vinculação automática de eventos está ativada. Caso contrário, false. O padrão é true. Para obter mais informações, consulte ASP.NET Web Server Control Event Model.

• ClassName
  Uma seqüência de caracteres que especifica o nome da classe para o controle que será compilado 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 da classe para o controle compilado baseia-se no nome de arquivo do controle.

  Outra página ou controle pode referenciar o nome da classe atribuído ao controle usando o @ Reference diretiva.

• ClientIDMode
  Especifica o algoritmo usar para gerar ClientID valores para controles. O valor padrão para uma página é AutoID.

  O valor padrão para controles é Inherit. Portanto, o algoritmo padrão para controles em um controle de usuário é determinado pelo ClientID a configuração do controle de usuário. Um valor padrão diferente pode ser definido no nível da página na @ Page diretiva ou do páginas elemento do arquivo Web. config. Para obter mais informações sobre os algoritmos, consulte ClientIDMode.

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

  Observação

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

• CodeFile
  Especifica um caminho para o arquivo referenciado code-behind para o controle. Esse atributo é usado em conjunto com o Inherits atributo para associar um arquivo de origem code-behind 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 ele é usado o CodeFile atributo deve estar presente. Use este atributo quando desejar implementar um cenário compartilhado, onde você define campos comuns (e opcionalmente, associado eventos) em uma classe base para fazer referência os controles declarados em um controle de usuário. Por causa do ASP.Modelo de geração de código NET, se você tiver definido os campos na classe base sem usar esse atributo, na compilação novas definições de membro de tempo 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 funcionaria. Mas se você usar o CodeFileBaseClass de atributo para associar a classe base com o controle de usuário e fazer sua classe parcial (seu nome é atribuído ao Inherits atributo e seu arquivo de origem é citado pelo CodeFile atributo) herdam da classe base, os campos na classe base será capazes de fazer referência os 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, portanto, os controles. aspx são compilados por padrão. Para obter detalhes, consulte a CompilationMode enumeração.

• CompilerOptions
  Uma seqüência de caracteres contendo opções do compilador usadas para compilar o controle. No C# e Visual Basic, isso é uma seqüê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 Visual Basic compilador de linha de comando.

• Debug
  Indica se o controle deve ser compilado com símbolos de depuração. trueSe o controle deve ser compilado com símbolos de depuração; Caso contrário, false. Como esta configuração afeta o desempenho, você só deve definir o atributo true durante o desenvolvimento.

• Description
  Fornece uma descrição de texto do controle. Este valor é ignorado pelo compilador do ASP.Analisador de rede.

• EnableTheming
  Indica se os temas são usados no controle. trueSe os temas são usados; Caso contrário, false. O padrão é true.

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

• Explicit
  Determina se o controle é compilado usando o Visual Basic Option Explicit modo. trueindica que a opção de compilação explícita de Visual Basic é ativada e que todas as variáveis devem ser declaradas em um Dim, Private, Public, ou ReDim instrução; Caso contrário, false. O padrão é false.

  Observação

  Esse atributo é ignorado pelo idiomas diferentes de Visual Basic.Além disso, essa opção é definida como true no arquivo de configuração Machine. config.Para obter mais informações, consulte Arquivos de configuração e ASP.NET Configuration Files.

• Inherits
  Define uma classe code-behind para o controle herdar. Isso pode ser qualquer classe que deriva de UserControl classe. Usado com o CodeFile atributo, que contém o caminho para o arquivo de origem para a classe code-behind. Para obter mais informações sobre classes code-behind, consulte ASP.NET Web Page Code Model.

• Language
  Especifica o idioma usado ao compilar todos os embutidos de renderização (% e < % = % >) e blocos de declaração dentro do controle de código. Valores podem representar qualquer.Idiomas com suporte a NET Framework, incluindo Visual Basic, C# ou JScript. Somente um idioma 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 do compilador que são freqüentemente usadas por ferramentas de depuração para marcar locais específicos em um arquivo de origem. trueSe os pragmas de linha devem ser gerados; Caso contrário, false.

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

  Você pode usar o Src atributo para vincular provedores de compilação para o controle. Para mais informações, consulte a classe BuildProvider. Além disso, nas versões do ASP.NET anteriores à versão 2.0, o Src atributo foi usado como uma maneira alternativa para vincular um arquivo code-behind para um controle. No ASP.NET versão 2.0, a abordagem preferencial para vincular um arquivo de origem 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 origem para a classe.

• Strict
  Indica que o controle deve ser compilado usando o Visual Basic OptionStrict modo. trueSe Option Strict está ativado. Caso contrário, false. O padrão é false.

  Observação

  Esse atributo é ignorado pelo idiomas diferentes de 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 é feita e o atributo é ignorado pelo analisador.

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

Remarks

Essa diretiva pode ser usada somente em controles de usuário. Controles de usuário são definidos em arquivos com a extensão. ascx. Você pode incluir apenas uma @ Control diretiva por arquivo. ascx. Além disso, você pode definir apenas uma Language de atributo por @ Control diretiva, porque somente um idioma pode ser usado por controle.

Para definir vários atributos para o @ Control diretiva, separe cada par atributo/valor com um único espaço. Para um atributo específico, não inclua um espaço nos dois lados do sinal de igual (=) que conecta o atributo com o seu valor. Por exemplo, consulte a seção exemplo deste tópico.

Exemplo

O exemplo de código a seguir instrui o ASP.Compilador NET personalizada para usar Visual Basic como o idioma de código embutido e desativa o salvamento de solicitações de estado através de HTTP usando o modo de exibição de EnableViewState atributo.

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

Consulte também

Reference

Sintaxe de diretiva de modelo de texto

@ Page

Other Resources

ASP.NET Page sintaxe

ASP.NET User Controls