ASP <asp>

Información general

El elemento <asp> especifica las opciones de configuración de una aplicación ASP. Estas incluyen opciones de configuración centradas en el desarrollador, como atributos que controlan la depuración y la configuración de devolución de errores. El elemento <asp> también incluye atributos que controlan el juego de caracteres usado por la aplicación, el lenguaje de script de la aplicación y si el registro de errores está habilitado para la aplicación.

El elemento <asp> también puede contener elementos que configuran COM+, almacenamiento en caché de ASP, límites de almacenamiento en búfer y estado de sesión para un sitio o aplicación.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <asp> no se modificó en IIS 10.0.
IIS 8.5	El elemento <asp> no se modificó en IIS 8.5.
IIS 8.0	El elemento <asp> no se modificó en IIS 8.0.
IIS 7.5	El elemento <asp> no se modificó en IIS 7.5.
IIS 7.0	El elemento <asp> se introdujo en IIS 7.0.
IIS 6,0	El elemento <asp> y sus elementos secundarios reemplazan las propiedades relacionadas con ASP en el objeto IIsWebService de IIS 6.0.

Configuración

Para admitir y configurar aplicaciones ASP en el servidor web, debe instalar el módulo ASP. Para instalar el módulo ASP, siga estos pasos.

Windows Server 2012 o Windows Server 2012 R2

1. En la barra de tareas, haga clic en Administrador del servidor.
2. En Administrador del servidor, haga clic en el menú Administrar y, después, haga clic en Agregar roles y características.
3. En el asistente para Agregar roles y características, haga clic en Siguiente. Seleccione el tipo de instalación y haga clic en Siguiente. Seleccione el servidor de destino y haga clic en Siguiente.
4. En la página Roles de servidor, expanda Servidor web (IIS), expanda Servidor web, expanda Desarrollo de aplicaciones y, a continuación, seleccione ASP.
   
5. Si el aparece el cuadro de diálogo ¿Agregar características necesarias para ASP?, haga clic en Agregar características. (Esta página solo aparece si aún no se ha instalado el servicio de rol de extensiones de ISAPI en el servidor).
6. En la página Roles de servidor, haga clic en Siguiente.
7. En la página Seleccionar características, haz clic en Siguiente.
8. En la página Confirmar selecciones de instalación, haga clic en Instalar.
9. En la página Resultados , haga clic en Cerrar.

Windows 8 o Windows 8.1

1. En la pantalla Inicio, mueva el puntero hasta la esquina inferior izquierda, haga clic con el botón derecho en el botón Inicio y, a continuación, haga clic en Panel de control.

2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.

3. Expanda sucesivamente Internet Information Services, World Wide Web Services y Características de desarrollo de aplicaciones y, a continuación, seleccione ASP.
   

   Nota:

   El rol de extensiones ISAPI se seleccionará si aún no se ha instalado.

4. Haga clic en OK.

5. Haga clic en Cerrar.

Windows Server 2008 o Windows Server 2008 R2

1. En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, luego, haga clic en Administrador del servidor.
2. En el panel de jerarquía del Administrador del servidor, expanda Roles y, luego, haga clic en Servidor web (IIS).
3. En el panel Servidor web (IIS), desplácese hasta la sección Servicios de rol y, luego, haga clic en Agregar servicios de rol.
4. En la página Seleccionar servicios de rol del Asistente para agregar servicios de rol, seleccione ASP.
   
5. Si aparece el cuadro de diálogo Agregar servicios de rol necesarios para ASP, haga clic en Agregar servicios de rol necesarios. (Esta página solo aparece si aún no se ha instalado el servicio de rol de extensiones de ISAPI en el servidor).
   
6. En la página Seleccionar servicios de rol, haga clic en Siguiente.
7. En la página Confirmar selecciones de instalación, haz clic en Instalar.
8. En la página Resultados , haga clic en Cerrar.

Windows Vista o Windows 7

1. En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.
3. Expanda Internet Information Services, luego World Wide Web Services y luego Características de desarrollo de aplicaciones.
4. Seleccione ASP y después haga clic en Aceptar.
   

Procedimientos

Cómo configurar ASP para un sitio o aplicación

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 o Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).

   • Si usa Windows 8 o Windows 8.1:

     • Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
     • En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Server 2008 o Windows Server 2008 R2:

     • En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Vista o Windows 7:

     • En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
     • Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el nombre del servidor, expanda Sitios y, a continuación, vaya al sitio web o a la aplicación web que desea configurar.

3. En el panel Inicio del sitio o la aplicación, haga doble clic en ASP.
   

4. En el panel ASP, configure las opciones necesarias y, a continuación, haga clic en Aplicar en el panel Acciones.
   

Configuración

Puede configurar el elemento <asp> en el nivel de servidor en el archivo ApplicationHost.config. Sin embargo, de forma predeterminada, no puede configurar el elemento <asp> en el nivel de sitio o en el nivel de aplicación.

Atributos

Atributo	Descripción
appAllowClientDebug	Atributo Boolean opcional. Especifica si la depuración del lado del cliente está habilitada. El valor predeterminado es false.
appAllowDebugging	Atributo Boolean opcional. Especifica si la depuración del lado del servidor está habilitada. El valor predeterminado es false.
bufferingOn	Atributo Boolean opcional. Especifica si el almacenamiento en búfer de la salida de la aplicación ASP está habilitado. El valor predeterminado es true.
calcLineNumber	Atributo Boolean opcional. Especifica si ASP calcula y almacena el número de línea de cada línea de código ejecutada para proporcionar el número en un informe de errores. El valor predeterminado es true.
codePage	Atributo uint opcional. Especifica el juego de caracteres predeterminado para una aplicación ASP. Este valor es un entero del intervalo comprendido entre 0 y 2147483647. Por ejemplo, el valor 1252 establece el carácter predeterminado establecido en un juego de caracteres latinos usado en inglés americano y muchos alfabetos europeos. El valor predeterminado es 0.
enableApplicationRestart	Atributo Boolean opcional. Especifica si las aplicaciones ASP se reinician automáticamente cada vez que se cambia una configuración. El valor predeterminado es true.
enableAspHtmlFallback	Atributo Boolean opcional. Especifica si un archivo .htm con el mismo nombre que el archivo de .asp solicitado, si existe, se enviará al cliente en lugar del archivo .asp. Esto se producirá en caso de que la solicitud se rechace debido a una cola de solicitudes completa. El valor predeterminado es true.
enableChunkedEncoding	Atributo Boolean opcional. Especifica si está habilitada la codificación de transferencia fragmentada HTTP 1.1. El valor predeterminado es true.
enableParentPaths	Atributo Boolean opcional. Especifica si las páginas ASP permiten rutas de acceso relativas al directorio actual o por encima del directorio actual. El valor predeterminado es false.
errorsToNTLog	Atributo Boolean opcional. Especifica si el registro de errores de ASP en el registro de eventos de Windows está habilitado. El valor predeterminado es false.
exceptionCatchEnable	Atributo Boolean opcional. Especifica si está habilitada la captura de excepciones del componente COM. Si está establecida en falso, la herramienta Microsoft Script Debugger no detectará excepciones enviadas por el componente que se está depurando. El valor predeterminado es true.
lcid	Atributo uint opcional. Especifica el identificador de configuración regional predeterminado para una aplicación ASP. Este valor es un entero del intervalo comprendido entre 0 y 2147483647. El valor predeterminado es 0.
logErrorRequests	Atributo Boolean opcional. Especifica si los errores de ASP se escriben en el explorador cliente y los registros de IIS de forma predeterminada. El valor predeterminado es true.
runOnEndAnonymously	Atributo Boolean opcional. Especifica si las funciones ASP globales SessionOnEnd y ApplicationOnEnd se ejecutan como usuario anónimo. El valor predeterminado es true.
scriptErrorMessage	Atributo de cadena opcional. Especifica el mensaje de error que se enviará al explorador cuando no se envíen errores de depuración específicos al cliente. El valor predeterminado es An error occurred on the server when processing the URL. Please contact the system administrator.
scriptErrorSentToBrowser	Atributo Boolean opcional. Especifica si la escritura de detalles de depuración en el explorador cliente está habilitada. El valor predeterminado es false.
scriptLanguage	Atributo de cadena opcional. Especifica el lenguaje de script predeterminado para todas las aplicaciones ASP que se ejecutan en el servidor web. El valor predeterminado es VBScript.

Elementos secundarios

Elemento	Descripción
cache	Elemento opcional. Especifica la configuración de caché de ASP.
comPlus	Elemento opcional. Especifica la configuración de COM+.
limits	Elemento opcional. Especifica límites para varias propiedades de ASP.
session	Elemento opcional. Especifica la configuración de estado de sesión de ASP.

Ejemplo de configuración

En el ejemplo de configuración siguiente se habilita el almacenamiento en búfer y el estado de sesión de las aplicaciones ASP en un sitio denominado Contoso y se deshabilitan las rutas de acceso primarias para ese mismo sitio.

<location path="Contoso">
   <system.webServer>
      <asp enableParentPaths="false" bufferingOn="true">
         <session allowSessionState="true" />
      </asp>
   </system.webServer>
</location>

Código de ejemplo

En los ejemplos de código siguientes se habilita el almacenamiento en búfer y el estado de sesión de las aplicaciones ASP en un sitio denominado Contoso y se deshabilitan las rutas de acceso primarias para ese mismo sitio.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/asp /enableParentPaths:"False" /commit:apphost
appcmd.exe set config "Contoso" -section:system.webServer/asp /bufferingOn:"True" /commit:apphost
appcmd.exe set config "Contoso" -section:system.webServer/asp /session.allowSessionState:"True" /commit:apphost

Nota:

Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();

         ConfigurationSection aspSection = config.GetSection("system.webServer/asp", "Contoso");
         aspSection["enableParentPaths"] = false;
         aspSection["bufferingOn"] = true;

         ConfigurationElement sessionElement = aspSection.GetChildElement("session");
         sessionElement["allowSessionState"] = true;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim aspSection As ConfigurationSection = config.GetSection("system.webServer/asp", "Contoso")
      aspSection("enableParentPaths") = False
      aspSection("bufferingOn") = True
      Dim sessionElement As ConfigurationElement = aspSection.GetChildElement("session")
      sessionElement("allowSessionState") = True
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Contoso");
aspSection.Properties.Item("enableParentPaths").Value = false;
aspSection.Properties.Item("bufferingOn").Value = true;
var sessionElement = aspSection.ChildElements.Item("session");
sessionElement.Properties.Item("allowSessionState").Value = true;

adminManager.CommitChanges();

VBScript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Contoso")
aspSection.Properties.Item("enableParentPaths").Value = False
aspSection.Properties.Item("bufferingOn").Value = True
Set sessionElement = aspSection.ChildElements.Item("session")
sessionElement.Properties.Item("allowSessionState").Value = True

adminManager.CommitChanges()