@ WebHandler

Definuje atributy a možnosti kompilace pro obslužnou rutinu žádosti o webovou stránku (.ashx).

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

v případě vícehodnotových atributů

• Class
  Určuje název třídy, která bude dynamicky zkompilována při požadavku na obslužnou rutinu. Tato hodnota se může odkazovat na jakoukoli třídu, která dědí z IHttpHandler a může obsahovat plně kvalifikovaný název třídy.

• CodeBehind
  Určuje název kompilovaného souboru, který obsahuje třídu přidruženou k obslužné rutině. Tento atribut není použit v době běhu.

  Poznámka
  Tento atribut je obsažen pro kompatibilitu s předchozími verzemi technologie ASP.NET.

• CompilerOptions
  Určuje řetězec obsahující volby použité pro sestavení obslužné rutiny. V jazyce C# a Visual Basic je to sekvence přepínačů příkazového řádku kompilátoru. Více informací o možnostech kompilátoru naleznete v Možnosti C# kompilátoru a Visual Basic Compiler.

• Debug
  true zda má být obslužná rutina kompilována se symboly ladění; v opačném případě false. Protože toto nastavení ovlivňuje výkon, nastavte atribut true pouze během vývoje.

• Description
  Obsahuje textový popis obslužné rutiny. Tato hodnota je ignorována analyzátorem technologie ASP.NET.

• Language
  Určuje jazyk používaný při kompilaci veškerého kódu v rámci obslužné rutiny. Hodnoty mohou představovat jakékoli jazyky podporované platformou .NET Framework včetně Visual Basic, C# nebo JScript. Na obslužnou rutinu lze použít pouze jeden jazyk.

• WarningLevel
  Označuje úroveň pro upozornění kompilátoru, při kterých chcete, aby kompilátor zacházel s upozorněními jako chybami, tedy přerušení sestavování obslužné rutiny. Možné úrovně pro upozornění jsou 0 až 4. Další informace naleznete v tématu o vlastnosti WarningLevel.

Poznámky

Tato směrnice je platná pouze v souborech použitých jako obslužná rutina žádosti o webovou stránku. Ve výchozím nastavení technologie ASP.NET zpracuje soubory s příponou .ashx jako obslužné rutiny.

Poznámka

Pokud nechcete pro vaše obslužné rutiny použít název přípony souboru .ashx, můžete vytvořit obslužnou rutinu jako standardní třídu (soubor .cs nebo .vb), která implementuje rozhraní IHttpHandler.Soubor třídy obslužné rutiny nevyžaduje direktivu @ WebHandler.Je třeba zaregistrovat upřednostňovaný název přípony souboru pomocí technologie ASP.NET.Další informace naleznete v tématu Postupy: Registrace obslužných rutin žádosti o webovou stránku.

Každý soubor .aspx může obsahovat pouze jednu direktivu @ WebHandler. Můžete definovat pouze jeden atribut Language pro direktivu @ WebHandler vzhledem k tomu, že v obslužné rutině může být použit pouze jeden jazyk.

Poznámka
Direktiva @ WebHandler má společně s jinými direktivami několik atributů, které jsou aplikovány pro celý zdrojový soubor, jako například direktiva @ Page, která se používá v souborech ASPX webových stránek.

Chcete-li definovat více atributů pro direktivu @ WebHandler, oddělte každý spárovat atribut/hodnotu mezerou. Nevkládejte mezeru na obou stranách symbolu rovná se (=), který spojuje atribut s jeho hodnotou.

Příklad

Následující příklad kódu dává pokyn kompilátoru stránky technologie ASP.NET k použití jako vloženého kódu jazyka Visual Basic a určuje název třídy.

<%@ WebHandler Language="VB" Class="MyTestHandler" %>

Viz také

Odkaz

Syntaxe šablony textu směrnice

@ Page

IHttpHandler

Handlers

Koncepty

Přehled obslužných rutin žádosti o webovou stránku a modulů protokolu HTTP