Referencia rápida de ASP

Referencia rápida ASP de CodeW3C.com. Imprímela, métela en el bolsillo, para usarla siempre que necesites.

Sintaxis básica

Los scripts ASP están encerrados entre <% y %>. De esta manera se envía contenido al navegador:

<html>
<body>
<% respuesta.write("¡Hola Mundo!") %>
</body>
</html>

El lenguaje predeterminado en ASP es VBScript. Si desea usar otro lenguaje de script, inserte una declaración de lenguaje en la parte superior de la página ASP:

<%@ language="javascript" %>
<html>
<body>
<%
....
%>

Formularios e entrada del usuario

Request.QueryString se utiliza para recopilar valores de un formulario con method="get". La información enviada a través de GET desde el formulario es visible para todos (se mostrará en la barra de direcciones del navegador) y también hay un límite en la cantidad de datos que se pueden enviar.

Request.Form se utiliza para recopilar valores de un formulario con method="post". La información enviada a través de POST desde el formulario no es visible para otros y no hay límite en la cantidad de datos que se pueden enviar.

Cookies de ASP

Las cookies se utilizan comúnmente para identificar usuarios. Las cookies son pequeños archivos que el servidor coloca en el ordenador del usuario. Cada vez que el mismo ordenador solicita una página a través del navegador, también envía la cookie.

La orden Response.Cookies se utiliza para crear cookies:

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2012"
%>

Nota: La orden Response.Cookies debe estar antes de la etiqueta <html>!

La orden "Request.Cookies" se utiliza para recuperar valores de cookies:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

Referencia de archivo

A través de la instrucción #include, puede insertar el contenido de un archivo ASP en otro ASP antes de que el servidor lo ejecute. La instrucción #include se utiliza para crear funciones, cabeceras, pies de página o elementos que se repiten en varias páginas.

Sintaxis:

<!--#include virtual="somefile.inc"-->

o

<!--#include file ="somefile.inc"-->

Por favor, utilice la palabra clave virtual para indicar la ruta que comienza con un directorio virtual. Si el archivo llamado "header.inc" se encuentra en el directorio virtual llamado /html, el siguiente código insertará el contenido de "header.inc":

<!-- #include virtual ="/html/header.inc" -->

Usa la palabra clave file para indicar rutas relativas. La ruta relativa comienza con el directorio que contiene el archivo que se está referenciando. Si tu archivo está en el directorio html y el archivo "header.inc" está en html\headers, el siguiente código insertará el contenido de "header.inc" en tu archivo:

<!-- #include file ="headers\header.inc" -->

Usa la palabra clave file y la sintaxis (..\) para referirte a archivos en directorios de nivel superior.

Global.asa

El archivo Global.asa es un archivo opcional que puede contener declaraciones de objetos, variables y métodos que pueden ser accedidos por cada página del aplicación ASP.

Comentarios: El archivo Global.asa debe estar ubicado en la raíz del aplicación ASP y cada aplicación solo puede tener un archivo Global.asa.

El archivo Global.asa solo puede contener lo siguiente:

  • Eventos de Application
  • Eventos de Session
  • <object> Declaración
  • Declaración de TypeLibrary
  • Instrucción #include

Eventos de Application y Session

En Global.asa, puedes indicar qué hacer cuando se inicia y finaliza una aplicación o sesión. El código para completar esta tarea se encuentra en los manipuladores de eventos.

Comentarios: Al insertar código en el archivo Global.asa, no utilizamos <% y %>, necesitamos colocar los subprocesos dentro de la etiqueta <script> de HTML:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' código some
end sub
sub Application_OnEnd
  ' código some
end sub
sub Session_OnStart
  ' código some
end sub
sub Session_OnEnd
  ' código some
end sub
</script>

<object> Declaración

También se pueden crear objetos con ámbito de sesión o aplicación utilizando la etiqueta <object> en Global.asa.

Comentarios: ¡El etiqueta <object> debe estar ubicado fuera de la etiqueta <script>!

Sintaxis:

<object runat="server" scope="scope" id="id">
{progid="progID"|classid="classID"}>
.......
</object>

Declaración de TypeLibrary

TypeLibrary es un contenedor de contenido de archivos DLL que corresponden a objetos COM. Al incluir llamadas a TypeLibrary en el archivo Global.asa, se puede acceder a los constantes de los objetos COM, y el código ASP también puede informar mejor de los errores. Si su aplicación web depende de objetos COM que han declarado tipos de datos en la biblioteca de tipos, puede declarar esa biblioteca de tipos en Global.asa.

Sintaxis:

<!--
METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->

Objeto de sesión

El objeto de sesión se utiliza para almacenar información sobre la sesión del usuario o para cambiar su configuración. Las variables almacenadas en el objeto de sesión contienen información sobre un usuario individual y pueden ser accedidas por todas las páginas de un programa.

Conjunto

  • Contents - Incluye todos los elementos adicionados a la sesión mediante comandos de script
  • StaticObjects - Contiene todos los objetos adicionados a la sesión mediante etiquetas <object> de HTML
  • Contents.Remove(elemento/índice) - Elimina un elemento de la colección Contents
  • Contents.RemoveAll() - Elimina todos los elementos de la colección Contents

Atributo

  • CodePage - Especifica el conjunto de caracteres utilizado para mostrar contenido dinámico
  • LCID - Establece el identificador de región utilizado para mostrar contenido dinámico
  • SessionID - Devuelve el id de sesión
  • Timeout - Establece o devuelve el tiempo de expiración de la sesión

Método

  • Abandonar - Revoca todos los objetos en el objeto de sesión.

Objeto Application

Un conjunto de archivos ASP que trabajan juntos para completar una tarea se llama una aplicación. El objeto Application en ASP se utiliza para agrupar estos archivos. Todos los usuarios comparten un objeto Application. El objeto Application debe contener información utilizada por muchas páginas del programa (por ejemplo, información de conexión a la base de datos).

Conjunto

  • Contenidos - Incluye todos los proyectos adicionados al programa mediante comandos de script
  • StaticObjects - Contiene todos los objetos que se han añadido a la aplicación utilizando la etiqueta <object> de HTML
  • Contents.Remove - Elimina un elemento de la colección Contents
  • Contents.RemoveAll - Elimina todos los elementos de la colección Contents

Método

  • Lock - Evita que el usuario modifique las variables del objeto Application
  • Unlock - Permite que el usuario modifique las variables del objeto Application

Objeto Response

El objeto Response se utiliza para enviar la salida del servidor al usuario.

Conjunto

Cookies(name) - Establece el valor del cookie. Si no existe, se crea el cookie y se establece el valor especificado.

Atributo

  • Buffer - Define si se debe buferizar la salida. Cuando se configura la salida en caché, el servidor bloquea la respuesta al navegador hasta que todos los scripts del servidor se hayan procesado o hasta que se llame a Flush o End. Si se debe configurar esta propiedad, debe estar ubicada antes de la etiqueta <html> en el archivo .asp.
  • CacheControl - Establece si el servidor de proxy puede cachear la salida generada por ASP. Si se establece en Public, el servidor de proxy cacheará la página.
  • Charset(charset_name) - Añadir el nombre del conjunto de caracteres al encabezado content-type del objeto de respuesta
  • ContentType - Establece el tipo de contenido HTTP del objeto de respuesta. (por ejemplo "text/html", "image/gif", "image/jpeg", "text/plain"). El valor predeterminado es "text/html"
  • Expires - Establece el tiempo de caché del navegador para la página antes de que expire (minutos)
  • ExpiresAbsolute - Establece la fecha y hora de expiración de la caché de la página en el navegador
  • IsClientConnected - Indica si el cliente se ha desconectado del servidor
  • Pics(pics_label) - Añadir valores alPICS de la cabecera de respuesta
  • Status - Define el valor de la línea de estado devuelta por el servidor

Método

  • AddHeader(name, value) - Añadir nuevos encabezados HTTP y valores a la respuesta HTTP
  • AppendToLog string - Añadir una cadena al final del registro del servidor (entrada de registro del servidor)
  • BinaryWrite(data_to_write) - Escribir datos directamente en la salida sin ninguna conversión de caracteres
  • Clear - Eliminar la salida en caché. Utilice este método para manejar errores. Si Response.Buffer no se establece en true, este método generará un error en tiempo de ejecución
  • End - Detener el procesamiento del script y devolver el resultado actual
  • Flush - Envía inmediatamente la salida en caché. Si Response.Buffer no se establece en true, este método generará un error en tiempo de ejecución
  • Redirect(url) - Redirigir al usuario a otra URL
  • Write(data_to_write) - Escribir texto para el usuario

Objeto Request

Cuando el navegador solicita una página al servidor, se llama solicitud. El objeto Request se utiliza para obtener información del usuario.

Conjunto

  • ClientCertificate - Incluye valores de campos almacenados en el certificado del cliente
  • Cookies(name) - Incluye valores de cookie
  • Form(element_name) - Incluye valores de formulario. Este formulario debe usar el método POST
  • QueryString(variable_name) - Incluye valores de variables en la cadena de consulta
  • ServerVariables(server_variable) - Incluye valores de variables de servidor

Atributo

  • TotalBytes - Devuelve el número total de bytes enviados por el cliente en el cuerpo de la solicitud

Método

  • BinaryRead - Recuperar los datos enviados desde el cliente al servidor como parte de una solicitud POST

Objeto Server

El objeto Server se utiliza para acceder a las propiedades y métodos del servidor.

Atributo

ScriptTimeout - Establecer o devolver cuánto tiempo puede ejecutarse un script antes de que se detenga.

Método

  • CreateObject(type_of_object) - Crear una instancia del objeto
  • Execute(ruta) - Ejecutar otro archivo ASP desde dentro de un archivo ASP. Después de que el archivo ASP llamado se haya ejecutado, el control se devuelve al archivo ASP original
  • ) - Devuelve el objeto ASPError que describe el error ocurrido
  • HTMLEncode(cadena) - Aplicar codificación HTML a una cadena
  • MapPath(ruta) - Mapear una ruta relativa o virtual a una ruta física
  • Transfer(ruta) - Enviar toda la información de estado a otro archivo para su procesamiento. Después de la transmisión, el control del programa no regresa al archivo ASP original
  • URLEncode(cadena) - Aplicar las reglas de codificación URL a la cadena

Fuente: http://www.codew3c.com/asp/asp_quickref.asp