Posteamelo

Crear una página ASP
Un archivo de páginas Active Server (ASP) es un archivo de texto con la extensión .asp que contiene
cualquier combinación de lo siguiente:
• Texto
• Etiquetas HTML
• Secuencias de comandos del servidor
Un método rápido para crear un archivo .asp consiste en cambiar la extensión de los archivos HTML
(.html o .htm) por la extensión .asp. Si el archivo no contiene funciones ASP, el servidor prescinde del
proceso de secuencias de comandos ASP y envía el archivo al cliente. Como desarrollador Web, esta
opción proporciona una gran flexibilidad, ya que puede asignar a los archivos la extensión .asp incluso si
no piensa agregar funciones ASP hasta más adelante.
Para publicar el archivo .asp en Web, guarde el nuevo archivo en un directorio virtual de su sitio Web
(asegúrese de que el directorio tenga los permisos Secuencia de comandos o Ejecución). A
continuación, escriba en el explorador la dirección URL del archivo para pedirlo. (Recuerde, las páginas
ASP debe enviarlas el servidor, por lo que no puede pedirlas mediante su ruta física.) Cuando el archivo
se cargue en el explorador, observará que el servidor envió una página HTML. Al principio puede
parecer extraño, pero recuerde que el servidor analiza y ejecuta todas las secuencias de comandos ASP
del servidor antes de enviar el archivo. El usuario siempre recibe código HTML estándar.
Para crear archivos .asp, se puede utilizar cualquier editor de textos. A medida que avance, puede que
encuentre más productivo utilizar un editor más orientado a ASP, como Microsoft(r) Visual InterDev™.
(Para obtener más información, visite el sitio Web de Microsoft Visual InterDev en la dirección
http://msdn.microsoft.com/vinterdev/.)
Agregar secuencias de comandos del servidor
Una secuencia de comandos del servidor es una serie de instrucciones que se utiliza para enviar al
servidor Web comandos de forma secuencial. (Si ya desarrolló antes sitios Web, probablemente
conozca las secuencias de comandos del cliente, que se ejecutan en el explorador Web.) En los
archivos .asp, las secuencias de comandos se separan del texto y de las etiquetas HTML mediante
delimitadores. Un delimitador es un carácter o una secuencia de caracteres que marca el principio o el
final de una unidad. En el caso de HTML, dichos delimitadores son los símbolos menor que (<

y mayor
que (>

, que enmarcan las etiquetas HTML.
ASP utiliza los delimitadores <% y %> para enmarcar los comandos. Dentro de los delimitadores puede
incluir cualquier comando válido dentro del lenguaje de secuencia de comandos que esté utilizando. El
ejemplo siguiente muestra una página HTML sencilla que contiene un comando de secuencia de
comandos:
<HTML>
<BODY>
Esta página se actualizó por última vez el <%= Now ()%>.
</BODY>
</HTML>
La función Now() de VBScript devuelve la fecha y la hora actuales. Cuando el servidor Web procesa
esta página, reemplaza <%= Now ()%> con la fecha y la hora actuales, y devuelve la página al
explorador con el siguiente resultado:
Esta página se actualizó el 1/29/99 2:20:00 p.m.
A los comandos enmarcados por delimitadores se les llama comandos principales de secuencias de
comandos, que se procesan mediante el lenguaje principal de secuencia de comandos. Todos los
comandos utilizados dentro de los delimitadores de secuencias de comandos deben ser válidos en el
lenguaje principal de secuencia de comandos. De forma predeterminada, el lenguaje principal de
secuencia de comandos es VBScript, pero también puede establecer un lenguaje diferente. Consulte
Trabajar con lenguajes de secuencias de comandos.
Si ya conoce las secuencias de comandos del cliente, ya sabrá que la etiqueta HTML <SCRIPT> se
utiliza para delimitar las secuencias de comandos y las expresiones. También puede utilizar la etiqueta
<SCRIPT> para las secuencias de comandos del cliente, siempre que necesite definir procedimientos en
múltiples lenguajes en un archivo .asp. Para obtener más información, consulte Trabajar con lenguajes
de secuencias de comandos.
Combinar HTML y comandos de secuencias de comandos
Dentro de los delimitadores de ASP puede incluir cualquier instrucción, expresión, procedimiento u
operador que sea válido en el lenguaje principal para secuencia de comandos. Una instrucción, en
VBScript y en otros lenguajes, es una unidad sintácticamente completa que expresa un tipo de acción,
declaración o definición. La instrucción condicional If...Then...Else que aparece a continuación es una
instrucción de VBScript muy común:
<%
Dim dtmHour
dtmHour = Hour(Now())
If dtmHour < 12 Then
Saludos = "Buenos días"
Else
strGreeting = "Hola"
End If
%>
<%= strGreeting %>
Según la hora, la secuencia de comandos asigna el valor "Buenos días" o el valor "Hola" a la variable de
cadena strGreeting. La instrucción <%= strGreeting %> envía al explorador el valor actual de la variable.
De esta forma, los usuarios que vean esta secuencia de comandos antes de las 12:00 de la mañana
(según la zona horaria del servidor Web) verían la siguiente línea de texto:
Buenos días
Los usuarios que vean esta secuencia de comandos después de las 12:00 de la mañana verían la
siguiente línea de texto:
Hola
Puede incluir texto HTML entre las secciones de una instrucción. Por ejemplo, la secuencia de
comandos siguiente, que combina HTML dentro de una instrucción If...Then...Else, produce el mismo
resultado que la del ejemplo anterior:
<%
Dim dtmHour
dtmHour = Hour(Now())
If dtmHour < 12 Then
%>
Buenos días
<% Else %>
Hola
<%End If %>
Si la condición es verdadera, es decir, si es antes del mediodía, el servidor Web envía al explorador el
código HTML que sigue a la condición (“Buenos días”); de lo contrario, envía el código HTML que sigue
a Else (“Hola”). Esta forma de combinar HTML y comandos de secuencia de comandos es cómoda para
continuar la instrucción If...Then...Else en varias líneas de texto HTML. El ejemplo anterior es más útil si
desea presentar un saludo en varias partes de una página Web. Puede asignar el valor de la variable
una única vez y después presentarla varias veces.
En lugar de mezclar texto HTML con comandos de secuencia de comandos, puede devolver texto HTML
al explorador desde dentro de los comandos de secuencia de comandos. Para devolver texto al
explorador, utilice el objeto integrado Response de ASP. El ejemplo siguiente produce el mismo
resultado que las secuencias de comandos anteriores:
<%
Dim dtmHour
dtmHour = Hour(Now())
If dtmHour < 12 Then
Response.Write "Buenos días"
Else
Response.Write "Hola"
End If
%>
Response.Write envía al explorador el texto que le sigue. Utilice Response.Write desde una
instrucción cuando desee generar de forma dinámica el texto devuelto al explorador. Por ejemplo, puede
generar una cadena de texto que contenga los valores de varias variables. Aprenderá más acerca del
objeto Response, y de los objetos en general, en Utilizar componentes y objetos y Enviar contenido al
explorador. Por ahora, observe simplemente que dispone de varias maneras de insertar comandos de
secuencias de comandos en las páginas HTML.
Puede incluir procedimientos escritos en su lenguaje predeterminado de secuencias de comandos
dentro de delimitadores ASP. Para obtener más información, consulte Trabajar con lenguajes de
secuencias de comandos.
Si va a trabajar con comandos JScript, puede insertar las llaves que indican un bloque de instrucciones
directamente en sus comandos ASP, incluso aunque estén entremezclados con etiquetas y texto HTML.
Por ejemplo:
<%
if (screenresolution == "low"

{
%>
Ésta es la versión de texto de la página.
<%
}
else
{
%>
Ésta es la versión multimedia de la página.
<%
}
%>
-O bien-
<%
if (screenresolution == "low"

{
Response.Write("Ésta es la versión de texto de la página."

}
else
{
Response.Write("Ésta es la versión multimedia de la página."

}
%>
Utilizar directivas ASP
ASP proporciona directivas que no forman parte de los lenguajes de secuencias de comandos: Dichas
directivas son la directiva de resultado y la directiva de proceso.
La directiva de resultado de ASP <%= expresión %> presenta el valor de una expresión. Dicha directiva
es equivalente al uso de Response.Write para presentar información. Por ejemplo, la expresión <%=
ciudad %> envía al explorador la palabra Barcelona (el valor actual de la variable).
La directiva de proceso de ASP <%@ palabra clave %> ofrece a ASP la información que necesita para
procesar un archivo .asp. Por ejemplo, la siguiente directiva establece VBScript como lenguaje principal
de secuencia de comandos de la página:
<%@ LANGUAGE=VBScript %>
Las directivas de proceso deben estar en la primera línea de los archivos .asp. Para agregar más de una
directiva a una página, deben incluirse en el mismo delimitador. No ponga las directivas de proceso en
los archivos incluidos con la instrucción #include. Debe incluir un espacio en blanco entre el signo @ y
la palabra clave. La directiva de proceso tiene las siguientes palabras clave:
• La palabra clave LANGUAGE establece el lenguaje principal de secuencia de comandos de la
página.
• La palabra clave ENABLESESSIONSTATE especifica si un archivo ASP utiliza el estado de la
sesión. Consulte Administrar sesiones.
• La palabra clave CODEPAGE establece la página de códigos (la codificación de caracteres) del
archivo .asp.
• La palabra clave LCID establece el identificador de configuración regional del archivo.
• La palabra clave TRANSACTION especifica que el archivo .asp se ejecutará dentro del contexto
de una transacción. Consulte Descripción de las transacciones
Importante Puede incluir más de una palabra clave en una única directiva. Los pares de palabra clave
y valor deben estar separados por un espacio. No ponga espacios ni antes ni después del signo igual
(=).
El ejemplo siguiente establece el lenguaje de secuencia de comandos y la página de códigos:
<%@ LANGUAGE="Jscript" CODEPAGE="932" %>
Espacio en blanco en las secuencias de comandos
Si su lenguaje principal de secuencias de comandos es VBScript o JScript, ASP quita el espacio en
blanco de los comandos. En otros lenguajes, ASP conserva el espacio en blanco para que los lenguajes
que interpreten la posición o la sangría puedan interpretarlo correctamente. El espacio en blanco incluye
espacios, tabuladores, retornos y saltos de línea.
En VBScript y JScript puede utilizar el espacio en blanco que sigue al delimitador de apertura y que
precede al de cierre para facilitar la lectura de los comandos. Todas las instrucciones siguientes son
válidas:
<% Color = "Green" %>
<%Color="Green"%>
<%
Color = "Green"
%>
ASP quita el espacio en blanco que se encuentre entre los delimitadores de cierre de las instrucciones y
los delimitadores de apertura de las instrucciones siguientes. Sin embargo, se recomienda utilizar
espacios para mejorar la legibilidad. Si tiene que conservar el espacio en blanco entre dos instrucciones,
como cuando vaya a presentar los valores de las variables en una frase, utilice el carácter de espacio de
no separación de HTML (&nbsp

. Por ejemplo:
<%
'Define dos variables con valores de cadena.
strFirstName = "Juan"
strLastName = "García"
%>
<P>Esta página Web está personalizada para "<%= strFirstName %> <%= strLastName %>."
</P>
Utilizar variables y constantes
Una variable es una ubicación de almacenamiento con nombre dentro de la memoria del equipo que
contiene datos, como un número o una cadena de texto. A los datos contenidos en una variable se les
llama valor de la variable. Las variables ofrecen una manera de almacenar, recuperar y manipular
valores mediante nombres que ayuden a entender lo que hace la secuencia de comandos.
Declarar y asignar nombre a variables
Siga las reglas y recomendaciones de su lenguaje de secuencias de comandos a la hora de declarar
variables y asignarles nombres. Incluso aunque no necesita declarar una variable para poder utilizarla,
es conveniente hacerlo porque ayuda a prevenir errores. Declarar una variable significa indicar al motor
de secuencias de comandos que existe una variable con un nombre concreto, de forma que pueda
hacer referencia a la variable a lo largo de una secuencia de comandos.
VBScript
VBScript no necesita declaraciones de variables, pero es conveniente declarar todas las variables antes
de utilizarlas. Para declarar una variable en VBScript, utilice la instrucción Dim, Public o Private. Por
ejemplo:
<% Dim NombreUsuario %>
Puede utilizar la instrucción Option Explicit de VBScript en los archivos .asp para hacer obligatoria la
declaración de variables con las instrucciones Dim, Private, Public y ReDim. La instrucción Option
Explicit debe aparecer después de las directivas ASP y antes del texto HTML o de los comandos de la
secuencia de comandos. Esta instrucción sólo afecta a los comandos ASP escritos en VBScript; no
afecta a los comandos escritos en JScript.
<% Option Explicit %>
<HTML>
<%
Dim strNombreUsuario
Public lngNumeroCuenta
%>
Alcance de las variables
El alcance, o vida, de una variable determina qué comandos de secuencia de comandos pueden tener
acceso a dicha variable. Una variable declarada dentro de un procedimiento tiene alcance local; la
variable se crea y se destruye cada vez que se ejecuta el procedimiento. No se puede tener acceso a
ella desde fuera del procedimiento. Una variable declarada fuera de un procedimiento tiene alcance
global; su valor es accesible y modificable desde cualquier comando de secuencia de comandos de una
página ASP.
Nota Al limitar el alcance de la variable a un procedimiento mejorará el rendimiento.
Si declara variables, una variable local y una variable global pueden tener el mismo nombre. La
modificación del valor de una de ellas no afecta al valor de la otra. Sin embargo, si no declara las
variables, podría modificar inadvertidamente el valor de una variable global. Por ejemplo, los siguientes
comandos de secuencia de comandos devuelven el valor 1 incluso aunque haya dos variables llamadas
Y:
<%
Option Explicit
Dim Y
Y = 1
SetLocalVariable
Response.Write Y
Sub SetLocalVariable
Dim Y
Y = 2
End Sub
%>
Por el contrario, los comandos siguientes devuelven el valor 2 porque las variables no se han declarado
de forma explícita. Cuando la llamada al procedimiento asigna a Y el valor 2, el motor de secuencias de
comandos da por supuesto que el procedimiento pretende modificar la variable global:
<%
Option Explicit
Dim Y = 1
SetLocalVariable
Response.Write Y
Sub SetLocalVariable
Y = 2
End Sub
%>
Para evitar problemas, adquiera el hábito de declarar explícitamente todas las variables. Lo cual es
especialmente importante si utiliza la instrucción #include para incluir archivos en su archivo ASP. La
secuencia de comandos incluida está contenida en un archivo aparte, pero se trata como si formara
parte del archivo contenedor. Es muy fácil olvidarse de que hay que utilizar nombres de variables
diferentes en la secuencia de comandos principal y en la secuencia de comandos incluida, a menos que
declare las variables.
Asignar a las variables alcance de sesión o de aplicación
Las variables globales sólo son accesibles en un mismo archivo ASP. Para hacer que una variable sea
accesible en varias páginas, asigne a la variable alcance de sesión o de aplicación. Las variables con
alcance de sesión están disponibles en todas las páginas de una aplicación ASP que pida un mismo
usuario. Las variables con alcance de aplicación están disponibles en todas las páginas de una
aplicación ASP que pida cualquier usuario. Las variables de sesión son una buena manera de
almacenar información para un único usuario, como sus preferencias o el nombre o la identificación del
usuario. Las variables de aplicación son una buena manera de almacenar información para todos los
usuarios de una determinada aplicación, como los saludos específicos o los valores generales
necesarios en la aplicación.
ASP proporciona dos objetos integrados en los que puede almacenar variables: el objeto Session y el
objeto Application.
También puede crear instancias de objetos con alcance de sesión o de aplicación. Para obtener más
información, consulte Establecer el alcance de los objetos.
Alcance de sesión
Para asignar alcance de sesión a una variable, almacénela en el objeto Session asignando un valor a
una entrada con nombre del objeto. Por ejemplo, los siguientes comandos almacenan dos nuevas
variables en el objeto Session:
<%
Session("Nombre"

= "Juan"
Session("Apellido"

= "Soto"
%>
Para recuperar la información del objeto Session, tenga acceso a la entrada con nombre mediante la
directiva de resultado (<%=) o Response.Write. En el ejemplo siguiente se utiliza la directiva de
resultado para presentar el valor actual de Session("Nombre"

:
Reciba nuestra bienvenida,<%= Session("Nombre"

%>
Puede almacenar las preferencias del usuario en el objeto Session y después tener acceso a dichas
preferencias para determinar qué página hay que devolver al usuario. Por ejemplo, puede permitir que
los usuarios especifiquen la versión en texto del contenido de la primera página de la aplicación y aplicar
esta opción a las siguientes páginas de la aplicación que el usuario visite.
<%
strScreenResolution = Session("ScreenResolution"

If strScreenResolution = "Low" Then
%>
Ésta es la versión de texto de la página.
<% Else %>
Ésta es la versión multimedia de la página.
<%End If %>
Nota Si hace referencia a una variable con alcance de sesión más de una vez en una secuencia de
comandos, piense en asignarle una variable local, como en el ejemplo anterior, para mejorar el
rendimiento.
Alcance de aplicación
Para asignar alcance de aplicación a una variable, almacénela en el objeto Application asignando un
valor a una entrada con nombre del objeto. Por ejemplo, el comando siguiente almacena en el objeto
Application un saludo específico de una aplicación:
<% Application("Saludo"

= "¡Reciba nuestra bienvenida al Departamento de ventas!" %>
Para recuperar la información del objeto Application, utilice la directiva de resultado de ASP (<%=) o
Response.Write para tener acceso a la entrada con nombre desde cualquier página posterior de la
aplicación. En el ejemplo siguiente se utiliza la directiva de resultado para presentar el valor de
Application("Saludo"

:
<%= Application("Saludo"

%>
De nuevo, si hace referencia a una variable con alcance de aplicación en su secuencia de comandos
repetidamente, debe de asignarle una variable local para mejorar el rendimiento.
Utilizar constantes
Una constante es un nombre que representa un número o una cadena. Algunos de los componentes de
base que se proporcionan con ASP, como ActiveX Data Objects (ADO), definen constantes que se
pueden utilizar en las secuencias de comandos. Un componente puede declarar constantes en la
biblioteca de tipos del componente, un archivo que contiene información acerca de los objetos y los tipos
aceptados por un componente COM. Después de haber declarado una biblioteca de tipos en su archivo
.asp puede usar las constantes definidas en cualquier secuencia de comandos en el mismo archivo .asp.
Igualmente, puede declarar una biblioteca de tipos en el archivo Global.asa para usar las constantes
definidas en cualquier archivo .asp de la aplicación.
Para declarar una biblioteca de tipos, utilice la etiqueta <METADATA> en su archivo .asp o Global.asa.
Por ejemplo, para declarar la biblioteca de tipos de ADO, utilice las siguientes instrucciones:

O bien, en lugar de hacer referencia al identificador único universal (UUID) de la biblioteca de tipos,
puede hacer referencia a la biblioteca de tipos mediante la ruta del archivo:

Entonces puede usar las constantes ADO en el archivo .asp donde declaró la biblioteca de tipos o en un
archivo que reside en una aplicación que contiene un archivo Global.asa con la declaración de biblioteca
de tipos ADO. En el ejemplo siguiente, adOpenKeyset y adLockOptimistic son constantes ADO:
<%
'Crea y abre el objeto Recordset.
Set rsCustomersList = Server.CreateObject("ADODB.Recordset"

rstCustomerList.ActiveConnection = cnnPubs
rstCustomerList.CursorType = adOpenKeyset
rstCustomerList.LockType = adLockOptimistic
%>
En la siguiente tabla se enumeran las bibliotecas de tipos y los identificadores UUID que se utilizan con
más frecuencia:
Biblioteca de tipos UUID
Biblioteca de Microsoft ActiveX Data
Objects 2.5
{00000205-0000-0010-8000-00AA006D2EA4}
Biblioteca de Microsoft CDO 1.2 para
Windows 2000 Server
{0E064ADD-9D99-11D0-ABE5-00AA0064D470}
Biblioteca MSWC de objetos
Advertisement Rotator
{090ACFA1-1580-11D1-8AC0-00C0F00910F9}
Biblioteca MSWC de objetos de
registro de IIS
{B758F2F9-A3D6-11D1-8B9C-080009DCC2FA}
Interactuar con secuencias de comandos del cliente
Es posible aumentar la eficacia de ASP si se utiliza para generar o manipular secuencias de comandos
del cliente. Por ejemplo, puede escribir secuencias de comandos del servidor que construyan
secuencias de comandos del cliente basadas en variables específicas del servidor, el tipo del explorador
o los parámetros de la petición HTTP.
Si intercala instrucciones de secuencias de comandos del servidor en las secuencias de comandos del
cliente (delimitadas mediante etiquetas HTML <SCRIPT>

, como se muestra en la plantilla del ejemplo
siguiente, puede inicializar de forma dinámica y alterar las secuencias de comandos del cliente en el
momento de realizar la petición:
<SCRIPT LANGUAGE="VBScript">

</SCRIPT>
Al incorporar estas funciones es posible crear algunas aplicaciones útiles e interesantes. Por ejemplo,
ésta es una sencilla secuencia de comandos del servidor (escrita en VBScript) que manipula una
secuencia de comandos del cliente (escrita en JScript):
<%
Dim dtmTime, strServerName, strServerSoftware, intGreeting
dtmTime = Time()
strServerName = Request.ServerVariables("SERVER_NAME"

strServerSoftware = Request.ServerVariables("SERVER_SOFTWARE"

'Genera un número aleatorio.
Randomize
GreetCondition = int(rnd * 3)
%>
<SCRIPT LANGUAGE="JScript">
<!--
//Llama a la función para mostrar el saludo
showIntroMsg()
function showIntroMsg()
{
switch(<%= intGreeting %>

{
case 0:
msg = "Este es el servidor Web <%= strServerName%> con <%= strServerSoftware %>."
break
case 1:
msg = "Reciba nuestra bienvenida al servidor Web <%= strServerName%>. La hora local es <%=
dtmTime %>."
break
case 2:
msg = "Este servidor utiliza <%= strServerSoftware %>."
break
}
document.write(msg)
}
-->
</SCRIPT>
Escribir procedimientos
Un procedimiento es un grupo de comandos de secuencia de comandos que realizan una tarea
específica y puede devolver un valor. Puede definir sus propios procedimientos e invocarlos
repetidamente desde sus secuencias de comandos.
Puede poner las definiciones de los procedimientos en el mismo archivo .asp que llama a los
procedimientos o bien puede poner los procedimientos utilizados con más frecuencia en un archivo .asp
compartido y utilizar la directiva #include para incluirlo en otros archivos .asp que llamen a los
procedimientos. Como alternativa, puede encapsular dicha funcionalidad en un componente COM.
Definir procedimientos
Las definiciones de los procedimientos pueden encontrarse dentro de etiquetas <SCRIPT> y </SCRIPT>
y deben seguir las reglas del lenguaje de secuencias de comandos. Utilice el elemento <SCRIPT> para
los procedimientos escritos en lenguajes distintos del lenguaje principal para secuencias de comandos.
Sin embargo, utilice los delimitadores de las secuencias de comandos (<% y %>

en los procedimientos
escritos en el lenguaje principal de secuencias de comandos.
Cuando utilice la etiqueta HTML <SCRIPT>, debe emplear dos atributos para asegurar el proceso de la
secuencia de comandos por parte del servidor. La sintaxis de la etiqueta <SCRIPT> es la siguiente:
<SCRIPT LANGUAGE=JScript RUNAT=SERVER>
definición del procedimiento
</SCRIPT>
El atributo RUNAT=SERVER indica al servidor Web que procese la secuencia de comandos en el
servidor. Si no establece este atributo, la secuencia de comandos la procesará el explorador del cliente.
El atributo LANGUAGE determina el lenguaje de secuencia de comandos utilizado en este bloque.
Puede especificar cualquier lenguaje para el que haya instalado un motor de secuencias de comandos
en el servidor. Para especificar VBScript, use el valor VBScript. Para especificar JScript, use el valor
JScript. Si no asigna el atributo LANGUAGE, el bloque de la secuencia de comandos se interpretará en
el lenguaje principal de secuencia de comandos.
Los comandos del bloque de la secuencia de comandos deben componer uno o varios procedimientos
completos en el lenguaje de secuencia de comandos elegido. Por ejemplo, los comandos siguientes
definen el procedimiento JScript MiFuncion.
<HTML>
<SCRIPT LANGUAGE=JScript RUNAT=SERVER >
function MiFuncion()
{
Response.Write("Llamó a MiFuncion()."

}
</SCRIPT>
Importante No incluya en las etiquetas <SCRIPT> del servidor comandos de secuencias de comandos
que no formen parte de procedimientos completos. Los comandos que no formen parte de un
procedimiento pueden provocar resultados impredecibles puesto que deben ejecutarse en un orden
determinado. Además, no puede utilizar la directiva de resultado de ASP <%=%> dentro de los
procedimientos. En su lugar, utilice Response.Write para enviar contenido al explorador.
Llamar a procedimientos
Para llamar a procedimientos, incluya el nombre de los procedimientos en un comando. Si va a llamar a
procedimientos JScript desde VBScript, debe utilizar paréntesis después del nombre del procedimiento;
si el procedimiento no tiene argumentos, utilice paréntesis vacíos. Si va a llamar a procedimientos
VBScript o JScript desde JScript, utilice siempre paréntesis después del nombre del procedimiento.
En VBScript también puede utilizar la palabra clave Call para llamar a un procedimiento. Sin embargo, si
el procedimiento al que llama requiere argumentos, la lista de argumentos debe aparecer entre
paréntesis. Si omite la palabra clave Call, también debe omitir los paréntesis en los que se incluye la
lista de argumentos. Si utiliza la sintaxis Call para llamar a una función integrada o definida por el
usuario, se descartará el valor devuelto por la función.
El ejemplo siguiente ilustra la creación y la llamada a procedimientos en dos lenguajes para secuencias
de comandos diferentes (VBScript y JScript).
<%@ LANGUAGE=VBScript %>
<HTML>
<BODY>
<% Echo %>
<BR>
<% printDate() %>
</BODY>
</HTML>
<%
Sub Echo
Response.Write "<TABLE>" & _
"Response.Write "<TR><TH>Nombre</TH><TH>Valor</TH></TR>"
Set objQueryString = Request.QueryString
For Each strSelection In objQueryString
Response.Write "<TR><TD>" & p & "</TD><TD>" & _
FormValues(strSelection) & "</TD></TR>"
Next
Response.Write "</TABLE>"
End Sub
%>
<SCRIPT LANGUAGE=JScript RUNAT=SERVER>
function PrintDate()
{
var x
x = new Date()
Response.Write(x.toString())
}
</SCRIPT>
Nota Las llamadas de VBScript a las funciones JScript no distinguen entre mayúsculas y minúsculas.
Pasar matrices a procedimientos
Para pasar una matriz entera a un procedimiento en VBScript, utilice el nombre de la matriz seguido de
paréntesis vacíos; en JScript, utilice corchetes vacíos.
Procesar los datos proporcionados por el usuario
Mediante el objeto Request de ASP puede crear sencillas y eficaces secuencias de comandos para
recopilar y procesar datos obtenidos de formularios HTML. En este tema no sólo aprenderá a crear
secuencias de comandos básicas para procesar formularios, sino que también conocerá técnicas útiles
para validar los datos de los formularios, tanto en su servidor Web como en el explorador de Web del
usuario.
Acerca de los formularios HTML
Los formularios HTML, el método más común para recopilar información desde el Web, consiste en un
conjunto de etiquetas HTML especiales que presentan elementos de interfaz de usuario en una página
Web. Los cuadros de texto, los botones y las casillas de verificación son ejemplos de elementos que
permiten que los usuarios intercalen con una página Web y envíen información a un servidor Web.
Por ejemplo, las siguientes etiquetas HTML generan un formulario en el que un usuario puede escribir su
nombre, apellido y edad, e incluye un botón para enviar la información a un servidor Web. El formulario
también contiene una etiqueta de entrada oculta (no presentada por el explorador Web) que puede
utilizar para pasar información adicional al servidor Web.
<FORM METHOD="Post" ACTION="Profile.asp">
<INPUT TYPE="text" NAME="Nombre">
<INPUT TYPE="text" NAME="Apellido">
<INPUT TYPE="text" NAME="Edad">
<INPUT TYPE="Hidden" NAME="EstadoUsuario" VALUE="Nuevo">
<INPUT TYPE="Submit" VALUE="Entrar">
</FORM>
Presentar con detalle el conjunto completo de etiquetas HTML para formularios se sale del ámbito de
este tema, sin embargo, hay numerosas fuentes de información que puede utilizar para aprender a crear
y utilizar formularios HTML. Por ejemplo, puede utilizar la posibilidad que ofrece su explorador para ver
el código fuente con el fin de examinar cómo se crean los formularios HTML en otros sitios Web.
También puede visitar el sitio Web de MSDN de Microsoft en la dirección http://msdn.microsoft.com/
para conocer las técnicas más recientes para utilizar los formularios HTML con otras tecnologías de
Internet.
Procesar datos de formularios con ASP
Después de crear el formulario HTML tendrá que procesar los datos proporcionados por el usuario, lo
que implica enviar la información a un archivo .asp para que la analice y manipule. De nuevo, examine el
código HTML del ejemplo anterior. Observe que el atributo ACTION de la etiqueta <FORM> hace
referencia a un archivo llamado Profile.asp. Cuando el usuario envía información HMTL, el explorador
utiliza el método POST para enviarla a un archivo .asp del servidor, en este caso Profile.asp. Este
archivo .asp puede contener archivos de comandos que procesen la información e interactúen con otras
secuencias de comandos, componentes COM o recursos, como una base de datos.
Existen tres formas básicas de recopilar información de un formulario HTML mediante ASP:
• Un archivo .htm estático puede contener un formulario que envíe sus valores a un archivo .asp.
• Un archivo .asp puede crear un formulario que envíe información a otro archivo .asp.
• Un archivo .asp puede crear un formulario que se envíe información a sí mismo; es decir, al
archivo .asp que contiene el formulario.
Los dos primeros métodos funcionan igual que los formularios que interactúan con otros programas de
servidor Web, con la única diferencia de que con ASP se simplifica mucho la tarea de recuperar y
procesar la información. El tercer método es especialmente útil y se muestra en la sección Validar los
datos de los formularios.
Obtener datos de los formularios
El objeto Request de ASP proporciona dos colecciones que facilitan la tarea de recuperar información
de los formularios enviados con las peticiones URL.
La colección QueryString
La colección QueryString recupera los valores del formulario pasados al servidor Web como texto a
continuación del signo de interrogación de la dirección URL de la petición. Los valores del formulario se
pueden anexar a la dirección URL de la petición mediante el método GET de HTTP o, manualmente, si
se agregan los valores del formulario a la dirección URL.
Si el ejemplo del formulario anterior utilizara el método GET (METHOD = "GET"

y el usuario escribiera
Juan, Soto y 30, se enviaría la siguiente petición URL al servidor:
http://Workshop1/Painting/Profile.asp?Nombre=Juan&Apellido=Soto&Edad=30&EstadoUsuario=Nuevo
El archivo Profile.asp podría contener la siguiente secuencia de comandos para procesar formularios:
Hola, <%= Request.QueryString("nombre"

%> <%= Request.QueryString("apellido"

%>.
Tiene <%= Request.QueryString("edad"

%> años.
<%
If Request.QueryString("EstadoUsuario"

= "Nuevo" Then
Response.Write"Ésta es su primera visita a este sitio Web"
End if
%>
En este caso, el servidor Web devolvería el texto siguiente al explorador Web del usuario:
Hola Juan Soto. Tiene 30 años. Ésta es su primera visita a este sitio Web
La colección QueryString también tiene un parámetro opcional que puede utilizar para tener acceso a
uno de los múltiples valores que se encuentran en el cuerpo de la petición URL (con el método GET).
También puede utilizar la propiedad Count para contar el número de veces que aparece un determinado
tipo de valor.
Por ejemplo, un formulario que contenga un cuadro de lista con varios elementos puede generar la
siguiente petición:
http://OrganicFoods/list.asp?Comida=Manzanas&Comida=Aceitunas&Comida=Pan
Podría utilizar el siguiente comando para contar los diferentes valores:
Request.QueryString("Comida"

.Count
Para presentar los tipos de valores, Lista.asp podría contener la secuencia de comandos siguiente:
<%
lngTotal = Request.QueryString("Comida"

.Count
For i = 1 To lngTotal
Response.Write Request.QueryString("Comida"

(i) & "<BR>"
Next
%>
La secuencia de comandos anterior mostraría:
Manzanas
Aceitunas
Pan
También puede mostrar la lista completa de valores como una cadena delimitada por comas, del modo
siguiente:
<% Response.Write Request.QueryString("Item"

%>
Aparecería la cadena siguiente:
Manzanas, Aceitunas, Pan
Colección Form
Cuando utiliza el método GET de HTTP para pasar a un servidor Web valores de un formulario grande y
complejo, corre el riesgo de perder información. Algunos servidores Web tienden a restringir el tamaño
de la cadena de petición de URL, por lo que los valores de los formularios grandes pasados con el
método GET podrían quedar truncados. Si necesita enviar una gran cantidad de información desde un
formulario a un servidor Web, debe utilizar el método POST de HTTP. El método POST, que envía los
datos de los formularios en el cuerpo de la petición HTTP, puede enviar un número casi ilimitado de
caracteres a un servidor. Puede utilizar la colección Form del objeto Request de ASP para recuperar los
valores enviados mediante el método POST.
La colección Form almacena valores de manera similar a la colección QueryString. Por ejemplo, si un
usuario completa un formulario escribiendo una larga lista de nombres, se podrían leer los nombres con
la secuencia de comandos siguiente:
<%
lngTotal = Request.Form("Comida"

.Count
For i = 1 To lngTotal
Response.Write Request.Form("Comida"

(i) & "<BR>"
Next
%>
Validar los datos de los formularios
Un formulario Web bien diseñado suele incluir una secuencia de comandos del cliente que valida los
datos proporcionados por el usuario antes de enviar la información al servidor. Las secuencias de
comandos de validación pueden comprobar si el usuario escribió un número válido o si un cuadro de
texto está en blanco. Imagine que su sitio Web incluye un formulario que permite calcular la tasa de
retorno de una inversión. Probablemente querrá comprobar si un usuario realmente escribió texto o
números en los campos apropiados del formulario, antes de enviar al servidor información que podría no
ser válida.
En general, lo mejor es realizar en el cliente tantas comprobaciones como sea posible. Además, de
poder preguntar antes al usuario por los errores, la validación en el cliente mejora el tiempo de
respuesta, reduce la carga del servidor y libera ancho de banda para otras aplicaciones.
La siguiente secuencia de comandos del cliente valida los datos escritos por el usuario (en este caso, la
secuencia de comandos determina si el número de cuenta que escribió el usuario es realmente un
número) antes de enviarlos al servidor:
<SCRIPT LANGUAGE="JScript">
function ComprobarNumero()
{
if (isNumeric(document.UserForm.AcctNo.value))
return true
else
{
alert("Escriba un número de cuenta válido."

return false
}
}
//Función para determinar si el valor del formulario es un número.
//Nota: El método isNaN JScript es un método más elegante para determinar si
//un valor no es un número. Sin embargo, algunos exploradores no admiten este método.
function isNumeric(str)
{
for (var i=0; i < str.length; i++)
{
var ch = str.substring(i, i+1)
if( ch < "0" || ch>"9" || str.length == null)
{
return false
}
}
return true
}
</SCRIPT>
<FORM METHOD="Get" ACTION="balance.asp" NAME="FormularioUsuario" ONSUBMIT="return
CheckNumber()">
<INPUT TYPE="Text" NAME="NumCuen">
<INPUT TYPE="Submit" VALUE="Enviar">
</FORM>
Sin embargo, si la validación de un formulario requiere el acceso a una base de datos debe considerar la
utilización de la validación del formulario en el servidor. Una forma muy útil de realizar la validación en el
servidor es crear formularios que se envíen la información a sí mismos. Es decir, el archivo .asp contiene
en realidad el formulario HTML que recibe los datos del usuario. (Recuerde, puede utilizar ASP para
interactuar con secuencias de comandos del cliente y código HTML. Para obtener más información,
consulte Interactuar con secuencias de comandos del cliente.) Los datos escritos vuelven al mismo
archivo, que se encarga de validar la información y avisa al usuario si éstos no son correctos.
Mediante este método se pueden mejorar las características de uso y la respuesta de los formularios
basados en Web. Por ejemplo, si se incluye información del error junto al campo del formulario en el que
se escribió la información incorrecta, será más fácil para el usuario descubrir el origen del error.
(Normalmente, los formularios basados en Web reenvían las peticiones a una página Web
independiente que contiene información del error. Los usuarios que no comprendan esta información
podrían sentirse frustrados.)
Por ejemplo, la secuencia de comandos siguiente determina si un usuario escribió un número de cuenta
válido, para lo que se envía la información a sí misma (Verify.asp) y llama a una función definida por el
usuario que realiza una consulta a una base de datos:
<%
strAcct = Request.Form("Cuenta"

If Not AccountValid(strAcct) Then
ErrMsg = "<FONT COLOR=Red>El número de cuenta que ha escrito no es válido.</FONT>"
Else
Procesa los datos del usuario
.
.
.
Server.Transfer("Complete.asp"

End If
Function AccountValid(strAcct)
Aquí se incluirá una secuencia de comandos o una llamada a un método de un componente de
conexión con una base de datos.
End Function
%>
<FORM METHOD="Post" ACTION="Verify.asp">
Número de cuenta: <INPUT TYPE="Text" NAME="Cuenta"> <%= ErrMsg %> <BR>
<INPUT TYPE="Submit">
</FORM>
En este ejemplo, la secuencia de comandos se encuentra en un archivo llamado Verify.asp, el mismo
archivo que contiene el formulario HTML y, para enviarse la información a sí mismo, especifica
Verify.asp en el atributo ACTION.
Importante Si utiliza JScript para la validación en el servidor, asegúrese de colocar un par de
paréntesis vacíos detrás del elemento de la colección Request (QueryString o Form) al asignar la
colección a una variable local. Sin el paréntesis la colección devolverá un objeto en lugar de una
cadena. La secuencia de comandos siguiente muestra el método correcto para asignar variables con
JScript:
<%
var Nombre = Request.Form("Nombre"

();
var Contraseña = Request.Form("Contraseña"

();
if(Nombre > ""

{
if(Nombre == Contraseña)
Response.Write("El nombre y la contraseña son iguales".)
else
Response.Write("El nombre y la contraseña son diferentes".);
}
%>
VBScript presenta el mismo comportamiento si la colección contiene varios valores separados por
comas o con los que se pueda crear un índice. Esto significa que tanto para VBScript como para JScript,
además de colocar un par de paréntesis detrás del elemento de la colección Request, necesitará
especificar el índice del valor deseado. Por ejemplo, la siguiente línea en JScript devuelve sólo el
primero de los varios valores de un elemento de un formulario:
var Nombre = Request.Form("Nombre"

(1);
Acceso al origen de datos
ActiveX Data Objects (ADO) es una tecnología ampliable y de fácil uso para agregar a sus páginas Web
acceso a bases de datos. Puede utilizar ADO para escribir secuencias de comandos compactas y
escalables que le permitan conectarse a orígenes de datos compatibles con OLE DB, como bases de
datos, hojas de cálculo, archivos de datos secuenciales o directorios de correo electrónico. OLE DB es
una interfaz de programación de nivel de sistema que proporciona un conjunto estándar de interfaces
COM para que permitan exponer las funciones del sistema de administración de bases de datos. Con el
modelo de objetos ADO es fácil tener acceso a estas interfaces (mediante lenguajes de secuencias de
comandos, como VBScript o JScript) para agregar funciones de bases de datos a las aplicaciones Web.
Además, también puede utilizar ADO para tener acceso a bases de datos compatibles con la
Conectividad abierta de bases de datos (ODBC, Open Database Connectivity).
Si no tiene mucha experiencia en conectividad con bases de datos, encontrará que la sintaxis de ADO
es sencilla y fácil de utilizar. Si es un programador experimentado, agradecerá el acceso escalable de
alto rendimiento que proporciona ADO para una gran variedad de orígenes de datos.
Crear una cadena de conexión
El primer paso en la creación de una aplicación de datos en Web consiste en proporcionar un método
para que ADO encuentre e identifique el origen de datos. Para ello se utiliza una cadena de conexión,
una serie de argumentos separados mediante un punto y coma que definen parámetros como el
proveedor del origen de datos y la ubicación del mismo. ADO utiliza la cadena de conexión para
identificar el proveedor OLE DB y para dirigir al proveedor al origen de datos. El proveedor es un
componente que representa el origen de datos y que expone la información en la aplicación en forma de
conjuntos de filas.
En la tabla siguiente se enumeran las cadenas de conexión de OLE DB para varios orígenes de datos
habituales:
Origen de datos Cadena de conexión OLE DB
Microsoft(r) Access Provider=Microsoft.Jet.OLEDB.4.0;Data Source=ruta física de
acceso al archivo .mdb
Microsoft SQL Server Provider=SQLOLEDB.1;Data Source=ruta de acceso a la base
de datos del servidor
Oracle Provider=MSDAORA.1;Data Source=ruta de acceso a la base
de datos del servidor
Microsoft Indexing Service Provider=MSIDXS.1;Data Source=ruta de acceso al archivo
Para proporcionar compatibilidad con versiones anteriores, el proveedor OLE DB para ODBC admite la
sintaxis de las cadenas de conexión ODBC. En la tabla siguiente se enumeran las cadenas de conexión
ODBC que se utilizan habitualmente:
Controlador del origen
de datos
Cadena de conexión ODBC
Microsoft Access Driver={Microsoft Access Driver (*.mdb)};DBQ=ruta física de
acceso al archivo .mdb
SQL Server DRIVER={SQL Server};SERVER=ruta de acceso al servidor
Oracle DRIVER={Microsoft ODBC for Oracle};SERVER=ruta de
acceso al servidor
Microsoft Excel Driver={Microsoft Excel Driver (*.xls)};DBQ=ruta física de
acceso al archivo .xls; DriverID=278
Microsoft Excel 97 Driver={Microsoft Excel Driver (*.xls)};DBQ=ruta física de
acceso al archivo .xls;DriverID=790
Paradox Driver={Microsoft Paradox Driver (*.db)};DBQ=ruta física de
acceso al archivo .db;DriverID=26
Texto Driver={Microsoft Text Driver (*.txt;*.csv)};DefaultDir=ruta física
de acceso al archivo .txt
Microsoft Visual
FoxPro(r) (con un
contenedor de bases de
datos)
Driver={Microsoft Visual FoxPro
Driver};SourceType=DBC;SourceDb=ruta física de acceso al
archivo .dbc
Microsoft Visual FoxPro
(sin un contenedor de
bases de datos)
Driver={Microsoft Visual FoxPro
Driver};SourceType=DBF;SourceDb=ruta física de acceso al
archivo .dbf
Conectarse al origen de datos
ADO proporciona el objeto Connection para establecer y administrar las conexiones entre las
aplicaciones y los orígenes de datos compatibles con OLE DB o las bases de datos compatibles con
ODBC. El objeto Connection incorpora propiedades y métodos que se pueden utilizar para abrir y cerrar
conexiones con bases de datos, y para enviar consultas de actualización de la información.
Para establecer una conexión con una base de datos, cree primero una instancia del objeto
Connection. Por ejemplo, la secuencia de comandos siguiente crea una instancia del objeto
Connection y procede a abrir una conexión:
<%
'Crea un objeto Connection.
Set cn = Server.CreateObject("ADODB.Connection"

'Abre una conexión mediante la cadena de conexión OLE DB.
cnn.Open "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C

atosMercadoVentasPrevistas.mdb"
%>
Nota La cadena de conexión no contiene espacios en blanco ni antes ni después del signo igual (=).
En este caso, el método Open del objeto Connection se refiere a la cadena de conexión.
Ejecutar consultas SQL con el objeto Connection
Con el método Execute del objeto Connection puede emitir comandos al origen de datos, como
consultas de SQL (Lenguaje de consulta estructurado). (SQL, lenguaje estándar para comunicarse con
bases de datos, define comandos para recuperar y actualizar información.) El método Execute acepta
parámetros que especifiquen el comando (o la consulta), el número de registros de datos a los que
afecta y el tipo de comando que se utiliza.
La siguiente secuencia de comandos utiliza el método Execute para enviar una consulta con un
comando INSERT de SQL, que inserta datos en una tabla concreta de la base de datos. En este
caso, el bloque de la secuencia de comandos inserta el nombre José Lugo en una tabla de la
base de datos llamada Customers.
<%
'Define la cadena de conexión OLE DB.
strConnectionString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C

atosEmpleados.mdb"
'Crea la instancia del objeto Connection y abre una conexión con la base de datos.
Set cn = Server.CreateObject("ADODB.Connection"

cnn.Open strConnectionString
'Define la instrucción SELECT de SQL.
strSQL = "INSERT INTO Customers (FirstName, LastName) VALUES ('José','Lugo')"
'Utiliza el método Execute para enviar una consulta SQL a la base de datos.
cnn.Execute strSQL,,adCmdText + adExecuteNoRecords
%>
Observe que se especifican dos parámetros en la instrucción que se utiliza para ejecutar la consulta:
adCmdText y adExecuteNoRecords. El parámetro opcional adCmdText especifica el tipo de comando e
indica que el proveedor debe evaluar la instrucción de consulta (en este caso, una consulta SQL) como
una definición textual de un comando. El parámetro adExecuteNoRecords indica a ADO que no debe
crear un conjunto de registros de datos si no se devuelven resultados a la aplicación. Este parámetro
sólo funciona con los tipos de comandos definidos como texto, como las consultas SQL, o con
procedimientos almacenados de bases de datos. Aunque los parámetros adCmdText y
adExecuteNoRecords son opcionales, debe especificarlos al utilizar el método Execute para mejorar así
el rendimiento de la aplicación de datos.
Importante Los parámetros ADO, como adCmdText, deben estar definidos para poder utilizarlos en una
secuencia de comandos. Un método cómodo para definir los parámetros consiste en utilizar una
biblioteca de tipos de componentes, que es un archivo que contiene definiciones para todos los
parámetros ADO. Para implementar una biblioteca de tipos de componentes debe declararla antes.
Agregue la etiqueta siguiente <METADATA> al archivo .asp o a Global.asa para declarar la biblioteca de
tipos ADO:

Si desea obtener más detalles acerca de cómo implementar las bibliotecas de tipos de componentes,
consulte la sección Utilizar constantes del tema Utilizar variables y constantes.
Además del comando INSERT de SQL, puede utilizar los comandos UPDATE y DELETE de SQL para
modificar y quitar información de la base de datos.
Con el comando UPDATE de SQL puede modificar los valores de los elementos de una tabla de la base
de datos. La siguiente secuencia de comandos usa el comando UPDATE para cambiar todos los
campos FirstName de la tabla Customers a Juan en todas las filas cuyo campo LastName contenga el
apellido Soto.
<%
Set cn = Server.CreateObject("ADODB.Connection"

cnn.Open "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C

atosEmpleados.mdb"
cn.Execute "UPDATE Customers SET FirstName = 'Juan' WHERE LastName = 'Soto' ",,adCmdText +
adExecuteNoRecords
%>
Para quitar determinados registros de una tabla de la base de datos, utilice el comando DELETE de
SQL. La siguiente secuencia de comandos quita todas las filas de la tabla Customers cuyo apellido sea
Soto:
<%
Set cn = Server.CreateObject("ADODB.Connection"

cnn.Open "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C

atosEmpleados.mdb"
cn.Execute "DELETE FROM Customers WHERE LastName = 'Soto'",,adCmdText +
adExecuteNoRecords
%>
Nota Debe tener mucho cuidado al utilizar el comando DELETE de SQL. Un comando DELETE que no
vaya acompañado de una cláusula WHERE eliminará todas las filas de la tabla. Asegúrese de incluir la
cláusula WHERE de SQL, que especifica las filas exactas que se van a eliminar.
Utilizar el objeto Recordset para manipular los resultados
Para recuperar datos, examinar resultados y modificar su base de datos, ADO proporciona el objeto
Recordset. El objeto Recordset tiene las funciones necesarias para, dependiendo de las restricciones de
las consultas, recuperar y presentar un conjunto de filas, o registros, de una base de datos. El objeto
Recordset mantiene la posición de cada registro devuelto por la consulta, lo que permite recorrer los
resultados de uno en uno.

Manual ASP

Dejá tu comentario

Autor del Post