ControlBuilderInterceptor – třída

Třída ControlBuilderInterceptor umožňuje přizpůsobení nebo řízení procesu kompilace.

Syntax

internal class ControlBuilderInterceptor

Varování

Třída ControlBuilderInterceptor je interní a není určená k použití přímo v kódu.

Jak je popsáno v části Poznámky, je možné zkontrolovat existenci tohoto typu a určit, zda je k dispozici podpora typu průsečíku. Společnost Microsoft nepodporuje žádné jiné použití této třídy v produkční aplikaci za jakýchkoli okolností.

Poznámky

V rozhraní .NET Framework 2.0 a .NET Framework 3.5 srpen 2020 aktualizace přidaly podporu pro použití typu průsečíku k přizpůsobení nebo řízení procesu kompilace. Tuto podporu můžete zjistit pomocí Type.GetType() ke kontrole existence typu ControlBuilderInterceptor, jak je znázorněno v následujícím kódu.

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

Pokud je návratová hodnota nenulová, je k dispozici podpora průsečíku. Pokud je vrácená hodnota nullnebo pokud dojde k výjimce, aktualizace ze srpna 2020 nebyly nainstalovány a podpora průsečíku chybí.

Pokud je k dispozici podpora průsečíku, můžete napsat a zaregistrovat typ průsečíku, který bude pracovat s procesem kompilace stejným způsobem, jakým ControlBuilderInterceptor provádí v novějších verzích rozhraní .NET Framework. V rozhraní .NET Framework 2.0 a .NET Framework 3.5 může být typ průsečíku libovolnou třídou, která splňuje následující požadavky:

• Má veřejný konstruktor bez parametrů.
• Má veřejné, nestatické metody pojmenované PreControlBuilderInit a OnProcessGeneratedCode, které mají stejný podpis a sémantiku jako PreControlBuilderInit(ControlBuilder, TemplateParser, ControlBuilder, Type, String, String, IDictionary, IDictionary) a OnProcessGeneratedCode(ControlBuilder, CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod, IDictionary) metody, které existují v novějších verzích rozhraní .NET Framework.

Zaregistrujte typ průsečíku pomocí klíče aspnet:20ControlBuilderInterceptor v nastavení aplikace ASP.NET (<appSettings>). Toto nastavení aplikace musí být uvedené v počítači nebo aplikaci web.config souboru. Zadejte typ průsečíku pomocí svého názvu typu kvalifikovaného sestavení. Následující příklad ukazuje, jak zaregistrovat typ průsečíku s názvem Fabrikam.Interceptor.

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

K načtení sestavení kvalifikovaného názvu typu použijte vlastnost Type.AssemblyQualifiedName, jak je znázorněno v následujícím kódu.

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

Pokud je k dispozici podpora průsečíku, proces kompilace komunikuje s uvedeným typem způsobem popsaným výše. Pokud chybí podpora průsečíku, nastavení aplikace se ignoruje a nemá žádný vliv.

Požadavky

obor názvů : System.Web.Compilation

sestavení : System.Web (v System.Web.dll)

verze rozhraní .NET Framework: 3.5, 2.0