Referencia rápida de ASP
Referencia rápida de ASP de W3Schools. Imprímelo y dóblalo en tu bolsillo.
Sintaxis básica
Los scripts ASP están rodeados por <% y %>. Para escribir alguna salida en un navegador:
<html>
<cuerpo>
<% respuesta.escribir("¡Hola mundo!") %>
</cuerpo>
</html>
El idioma predeterminado en ASP es VBScript. Para utilizar otro lenguaje de secuencias de comandos, inserte una especificación de idioma en la parte superior de la página ASP:
<%@ idioma="javascript" %>
<html>
<cuerpo>
<%
....
%>
Formularios y entrada del usuario
Request.QueryString se utiliza para recopilar valores en un formulario con method="get". La información enviada desde un formulario con el método GET es visible para todos (se mostrará en la barra de direcciones del navegador) y tiene límites en la cantidad de información a enviar.
Request.Form se utiliza para recopilar valores en un formulario con method="post". La información enviada desde un formulario con el método POST es invisible para los demás y no tiene límites en la cantidad de información a enviar.
Cookies ASP
Una cookie se utiliza a menudo para identificar a un usuario. Una cookie es un pequeño archivo que el servidor incrusta en la computadora del usuario. Cada vez que la misma computadora solicite una página con un navegador, también enviará la cookie.
El comando Response.Cookies se utiliza para crear cookies:
<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="10 de mayo de 2002"
%>
Nota: ¡El comando Response.Cookies debe aparecer ANTES de la etiqueta <html>!
El comando "Request.Cookies" se utiliza para recuperar un valor de cookie:
<%
fname=Request.Cookies("firstname")
respuesta.write("Firstname=" & fname)
%>
Incluyendo archivos
Puede insertar el contenido de un archivo ASP en otro archivo ASP antes de que el servidor lo ejecute, con la directiva #include. La directiva #include se usa para crear funciones, encabezados, pies de página o elementos que se reutilizarán en varias páginas.
Sintaxis:
<!--#include virtual="algunarchivo.inc"-->
o
<!--#include file ="algunarchivo.inc"-->
Utilice la palabra clave virtual para indicar una ruta que comience con un directorio virtual. Si un archivo llamado "header.inc" reside en un directorio virtual llamado /html, la siguiente línea insertaría el contenido de "header.inc":
<!-- #include virtual="/html/header.inc" -->
Utilice la palabra clave de archivo para indicar una ruta relativa. Una ruta relativa comienza con el directorio que contiene el archivo incluido. Si tiene un archivo en el directorio html y el archivo "header.inc" reside en html\headers, la siguiente línea insertaría "header.inc" en su archivo:
<!-- #incluye archivo ="headers\header.inc" -->
Utilice la palabra clave de archivo con la sintaxis (..\) para incluir un archivo de un directorio de nivel superior.
global.asa
El archivo Global.asa es un archivo opcional que puede contener declaraciones de objetos, variables y métodos a los que se puede acceder desde todas las páginas de una aplicación ASP.
Nota: El archivo Global.asa debe almacenarse en el directorio raíz de la 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 aplicación
- Eventos de sesión
- <objeto> declaraciones
- Declaraciones de TypeLibrary
- la directiva #include
Eventos de aplicación y sesión
En Global.asa puede decirle a los objetos de la aplicación y la sesión qué hacer cuando se inicia la aplicación/sesión y qué hacer cuando finaliza la aplicación/sesión. El código para esto se coloca en los controladores de eventos. Nota: No usamos <% y %>, para insertar scripts en el archivo Global.asa, tenemos que poner las subrutinas dentro de la etiqueta HTML <script>:
<script language="vbscript" runat="server">
sub Application_OnStart
' algún código
final sub
sub Application_OnEnd
' algún código
final sub
sub Session_OnStart
' algún código
final sub
sub Session_OnEnd
' algún código
final sub
</script>
<objeto> Declaraciones
También es posible crear objetos con alcance de sesión o aplicación en Global.asa usando la etiqueta <object>. Nota: ¡La etiqueta <object> debe estar fuera de la etiqueta <script>!
Sintaxis:
<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>
Declaraciones de TypeLibrary
Una TypeLibrary es un contenedor para el contenido de un archivo DLL correspondiente a un objeto COM. Al incluir una llamada a TypeLibrary en el archivo Global.asa, se puede acceder a las constantes del objeto COM y el código ASP puede informar mejor de los errores. Si su aplicación web se basa en objetos COM que han declarado tipos de datos en bibliotecas de tipos, puede declarar las bibliotecas de tipos en Global.asa.
Sintaxis:
<!--TIPO DE METADATOS="TypeLib"
file="nombre de archivo" uuid="typelibraryuuid
"
version="número de versión"
lcid="localeid"
-->
El objeto de sesión
El objeto Session se utiliza para almacenar información o cambiar la configuración de una sesión de usuario. Las variables almacenadas en el objeto Session contienen información sobre un solo usuario y están disponibles para todas las páginas en una aplicación.
Colecciones
- Contenido: contiene todos los elementos agregados a la sesión con comandos de script
- StaticObjects: contiene todos los objetos agregados a la sesión con la etiqueta <object> y una sesión determinada
- Contents.Remove ( elemento/índice ): elimina un elemento de la colección de contenido
- Contents.RemoveAll(): elimina todos los elementos de la colección de contenido
Propiedades
- CodePage: establece la página de códigos que se utilizará para mostrar contenido dinámico
- LCID: establece el identificador de configuración regional que se utilizará para mostrar contenido dinámico
- SessionID - Devuelve el id de la sesión
- Tiempo de espera: establece el tiempo de espera para la sesión
Método
- Abandonar: mata todos los objetos en un objeto de sesión
Objeto de aplicación
Un grupo de archivos ASP que funcionan juntos para realizar algún propósito se denomina aplicación. El objeto Aplicación en ASP se utiliza para unir estos archivos. Todos los usuarios comparten un objeto Aplicación. El objeto Aplicación debe contener información que será utilizada por muchas páginas de la aplicación (como información de conexión a la base de datos).
Colecciones
- Contenido: contiene todos los elementos agregados a la aplicación con comandos de script
- StaticObjects: contiene todos los objetos agregados a la aplicación con la etiqueta <object>
- Contents.Remove: elimina un elemento de una colección
- Contents.RemoveAll: elimina todos los elementos de una colección
Métodos
- Bloquear: evita que un usuario cambie las propiedades del objeto de la aplicación
- Desbloquear: permite a un usuario cambiar las propiedades del objeto de la aplicación
El objeto de respuesta
El objeto de respuesta se utiliza para enviar resultados al usuario desde el servidor.
Colección
- Cookies (nombre): establece un valor de cookie. Si la cookie no existe, se creará y tomará el valor que se especifica
Propiedades
- Búfer: si almacenar o no la salida en búfer. Cuando la salida se almacena en búfer, el servidor retendrá la respuesta hasta que se hayan procesado todos los scripts del servidor, o hasta que el script llame al método Flush o End. Si se establece esta propiedad, debe estar antes de la etiqueta <html> en el archivo ASP
- CacheControl: establece si los servidores proxy pueden almacenar en caché la salida o no. Cuando se establece en Público, la salida puede ser almacenada en caché por un servidor proxy
- Charset( charset_name): establece el nombre del conjunto de caracteres (como "ISO8859-1") en el encabezado del tipo de contenido.
- ContentType: establece el tipo de contenido HTTP (como "text/html", "image/gif", "image/jpeg", "text/plain"). El valor predeterminado es "texto/html"
- Caduca: establece cuánto tiempo se almacenará en caché una página en un navegador antes de que caduque
- ExpiresAbsolute: establece una fecha y hora en que caducará una página almacenada en caché en un navegador
- IsClientConnected: comprueba si el cliente todavía está conectado al servidor
- Fotos ( pics_label ): agrega un valor al encabezado de respuesta de la etiqueta de fotos
- Estado: especifica el valor de la línea de estado
Métodos
- AddHeader ( nombre, valor ): agrega un encabezado HTML con un valor específico
- Cadena AppendToLog : agrega una cadena al final de la entrada de registro del servidor
- BinaryWrite ( data_to_write ): escribe la información dada sin ninguna conversión de juego de caracteres
- Borrar: borra la salida almacenada en búfer. Utilice este método para manejar los errores. Si Response.Buffer no se establece en verdadero, este método provocará un error en tiempo de ejecución
- Fin: detiene el procesamiento del script y devuelve el resultado actual
- Flush: envía la salida almacenada en búfer inmediatamente. Si Response.Buffer no se establece en verdadero, este método provocará un error en tiempo de ejecución
- Redirigir ( url ): redirige al usuario a otra URL
- Write( data_to_write ) - Escribe un texto para el usuario
Objeto de solicitud
Cuando un navegador solicita una página de un servidor, se denomina solicitud. El objeto de solicitud se utiliza para obtener información del usuario.
Colección
- ClientCertificate: contiene valores de campo almacenados en el certificado del cliente
- Cookies ( nombre ): contiene valores de cookies
- Form( element_name ) - Contiene valores de formulario (entrada). El formulario debe usar el método post
- QueryString( variable_name ) - Contiene valores de variables en la cadena de consulta
- ServerVariables( server_variable ) - Contiene valores de variables de servidor
Propiedad
- TotalBytes: contiene el número total de bytes que el cliente envía en el cuerpo de la solicitud.
Método
- BinaryRead: obtiene los datos que se envían al servidor desde el cliente como parte de una solicitud posterior
Objeto de servidor
El objeto de servidor se utiliza para acceder a propiedades y métodos en el servidor.
Propiedad
- ScriptTimeout: establece cuánto tiempo puede ejecutarse un script antes de que finalice
Método
- CreateObject( type_of_object ) - Crea una instancia de un objeto
- Ejecutar ( ruta ): ejecuta un archivo ASP desde dentro de otro archivo ASP. Después de ejecutar el archivo ASP llamado, el control vuelve al archivo ASP original
- GetLastError() - Devuelve un objeto ASPError que describirá el error que ocurrió
- HTMLEncode( cadena ) - Aplica codificación HTML a una cadena
- MapPath ( ruta ): asigna una ruta relativa o virtual a una ruta física
- Transferencia ( ruta ): envía toda la información de estado a otro archivo ASP para su procesamiento. Después de la transferencia, el control de procedimiento no se devuelve al archivo ASP original
- URLEncode( string ) - Aplica reglas de codificación de URL a una cadena
Fuente: https://www.w3schools.com/asp/asp_quickref.asp