@ WebHandler

Definisce gli attributi e le opzioni di compilazione per i file del gestore HTTP (con estensione ashx).

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

Attributi

• Class
  Specifica il nome della classe che verrà compilata in modo dinamico quando il gestore viene richiesto. Questo valore può fare riferimento a qualsiasi classe che eredita da IHttpHandler e può includere un nome di classe completo.

• CodeBehind
  Specifica il nome del file compilato contenente la classe associata al gestore. Questo attributo non viene utilizzato in fase di esecuzione.

  Nota
  Questo attributo è incluso per garantire la compatibilità con le versioni precedenti di ASP.NET.

• CompilerOptions
  Specifica una stringa contenente le opzioni utilizzate per la compilazione del gestore. In C# e Visual Basic si tratta di una sequenza di opzioni della riga di comando del compilatore. Per ulteriori informazioni sulle opzioni del compilatore, vedere Opzioni del compilatore C# o Visual Basic Compiler.

• Debug
  Impostato su true se il gestore deve essere compilato con simboli di debug; in caso contrario su false. Poiché questa impostazione influisce in modo significativo sulle prestazioni, impostare l'attributo su true solo durante lo sviluppo.

• Description
  Fornisce una descrizione in formato testo del gestore. Questo valore viene ignorato dal parser ASP.NET.

• Language
  Specifica il linguaggio utilizzato per la compilazione del codice all'interno del gestore. I valori possono rappresentare qualsiasi linguaggio .NET Framework, inclusi Visual Basic, C# o JScript. È possibile utilizzare un solo linguaggio per gestore.

• WarningLevel
  Indica il livello di avviso del compilatore raggiunto il quale questo considera gli avvisi come errori sospendendo la compilazione del gestore. I livelli di avviso possibili sono compresi tra 0 e 4. Per ulteriori informazioni, vedere la proprietà WarningLevel.

Note

Questa direttiva è valida solo nei file utilizzati come gestori HTTP. Per impostazione predefinita, ASP.NET tratta i file con estensione ashx come gestori.

Nota

Se non si desidera utilizzare l'estensione ashx per i gestori, è possibile creare un gestore come classe standard (un file con estensione cs o vb) che implementa l'interfaccia IHttpHandler.Un file di classe del gestore non richiede la direttiva @ WebHandler.È necessario quindi registrare l'estensione di file preferita in ASP.NET.Per informazioni dettagliate, vedere Procedura: registrare gestori HTTP.

È possibile includere una sola direttiva @ WebHandler per file. È possibile definire un solo attributo Language per direttiva @ WebHandler direttiva, in quanto si può utilizzare un solo linguaggio per gestore.

Nota
La direttiva @ WebHandler ha un numero di attributi in comune con le altre direttive che si riferiscono a un intero file di origine intero, ad esempio la direttiva @ Page utilizzata nei file con estensione aspx per le pagine Web.

Per definire più attributi per la direttiva @ WebHandler, separare ogni coppia attributo/valore inserendo uno spazio singolo. Non inserire uno spazio prima e dopo il segno di uguale (=) che collega l'attributo al rispettivo valore.

Esempio

Nell'esempio di codice seguente al compilatore di pagine ASP.NET viene indicato di utilizzare Visual Basic come linguaggio del codice inline e viene specificato un nome di classe.

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

Vedere anche

Riferimenti

Sintassi della direttiva template di testo

@ Page

IHttpHandler

Handlers

Concetti

Cenni preliminari su gestori HTTP e moduli HTTP