ControlBuilderInterceptor classe

A classe ControlBuilderInterceptor permite que o processo de compilação seja personalizado ou controlado.

Sintaxe

internal class ControlBuilderInterceptor

Advertência

A classe ControlBuilderInterceptor é interna e não se destina a ser usada diretamente em seu código.

Conforme descrito na seção Observações, a existência desse tipo pode ser verificada para determinar se o suporte ao tipo intercetor está presente. A Microsoft não oferece suporte a qualquer outro uso dessa classe em um aplicativo de produção em nenhuma circunstância.

Comentários

No .NET Framework 2.0 e no .NET Framework 3.5, as atualizações de de agosto de 2020 do adicionaram suporte ao uso de um tipo de intercetador para personalizar ou controlar o processo de compilação. Você pode determinar se esse suporte está presente usando Type.GetType() para verificar a existência do tipo ControlBuilderInterceptor, conforme demonstrado no código a seguir.

Type type = Type.GetType("System.Web.Compilation.ControlBuilderInterceptor, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a");

Se o valor de retorno for não-nulo, o suporte ao intercetador estará presente. Se o valor de retorno for nullou se uma exceção for lançada, as atualizações de agosto de 2020 não foram instaladas e o suporte ao intercetor está ausente.

Se o suporte ao intercetor estiver presente, você poderá escrever e registrar um tipo de intercetador que interagirá com o processo de compilação exatamente da mesma maneira que ControlBuilderInterceptor faz em versões posteriores do .NET Framework. No .NET Framework 2.0 e no .NET Framework 3.5, o tipo de intercetador pode ser qualquer classe que atenda aos seguintes requisitos:

• Tem um construtor público, sem parâmetros.
• Tem métodos públicos e não estáticos chamados PreControlBuilderInit e OnProcessGeneratedCode que têm a mesma assinatura e semântica que os métodos PreControlBuilderInit(ControlBuilder, TemplateParser, ControlBuilder, Type, String, String, IDictionary, IDictionary) e OnProcessGeneratedCode(ControlBuilder, CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod, IDictionary), que existem em versões posteriores do .NET Framework.

Registre o tipo de intercetador usando a chave aspnet:20ControlBuilderInterceptor em ASP.NET configurações do aplicativo (<appSettings>). Essa configuração do aplicativo deve estar listada no seu computador ou arquivo de web.config do aplicativo. Especifique o tipo de intercetador usando seu nome de tipo qualificado para assembly. O exemplo a seguir mostra como registrar um tipo de intercetador chamado Fabrikam.Interceptor.

<configuration>
  ...
  <appSettings>
    ...
    <add key="aspnet:20ControlBuilderInterceptor"
         value="Fabrikam.Interceptor, Fabrikam, Version=1.0.0.0, Culture=neutral, PublicKeyToken=2b3831f2f2b744f7" />
  </appSettings>
</configuration>

Para recuperar o nome qualificado para assembly de um tipo, use a propriedade Type.AssemblyQualifiedName, conforme demonstrado no código a seguir.

string assemblyQualifiedName = typeof(Fabrikam.Interceptor).AssemblyQualifiedName;

Quando o suporte ao intercetor está presente, o processo de compilação interage com o tipo listado da maneira descrita acima. Quando o suporte ao intercetor está ausente, a configuração do aplicativo é ignorada e não tem efeito.

Requerimentos

Namespace: System.Web.Compilation

Assembly: System.Web (em System.Web.dll)

versões do .NET Framework: 3.5, 2.0