ControlBuilderInterceptor classe

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

Sintaxe

internal class ControlBuilderInterceptor

Aviso

A ControlBuilderInterceptor classe é 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.

Observações

No .NET Framework 2.0 e no .NET Framework 3.5, as atualizações de agosto de 2020 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 ControlBuilderInterceptor tipo, 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 null, ou 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 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, não estáticos nomeados PreControlBuilderInit e OnProcessGeneratedCode que têm a mesma assinatura e semântica que os PreControlBuilderInit(ControlBuilder, TemplateParser, ControlBuilder, Type, String, String, IDictionary, IDictionary) métodos and OnProcessGeneratedCode(ControlBuilder, CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod, IDictionary) , que existem em versões posteriores do .NET Framework.

Registre o tipo de intercetador usando a aspnet:20ControlBuilderInterceptor chave em ASP.NET configurações do aplicativo (<appSettings>). Essa configuração do aplicativo deve estar listada no seu computador ou no arquivo 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 Type.AssemblyQualifiedName propriedade, 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.

Requisitos

Espaço de nomes: System.Web.Compilation

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

Versões do .NET Framework: 3.5, 2.0