Prctica A: seguimiento en aplicaciones Web Microsoft

ASP.NET
Logon
Logon Page
Page
Login.aspx
Login.aspx
Benefits
Benefits
Coho Home
Home Page
Page Page
Page Header
Header ASPState
Winery Default.aspx
Default.aspx Header.ascx
Menu
Menu Header.ascx
Registration
Registration Component
Component
Register.aspx
Register.aspx Class1.vb Web.
Class1.vb or
or Class1.cs
Class1.cs tempdb
config

Life
Life Insurance
Insurance Retirement
Retirement Medical
Medical Dental
Dental
Life.aspx
Life.aspx Retirement.aspx
Retirement.aspx Medical.aspx
Medical.aspx Dental.aspx
Dental.aspx

Prospectus Doctors User XML

XML Web
Web
Prospectus Doctors User Control
Lab Web Prospectus.aspx
Prospectus.aspx Doctors.aspx
Doctors.aspx namedate.ascx
namedate.ascx Service
Service
Application dentalService1.asmx
dentalService1.asmx

XML
Doctors Dentists
Files

***************************** use******************************

Objetivos En este laboratorio, aprenderemos a:

Agregar instrucciones de seguimiento a un formulario Web Form
Microsoft ASP.NET.
Habilitar y deshabilitar el seguimiento (Trace) a nivel de pgina y de
aplicacin.
Utilizar el seguimiento en un componente.

Nota Este laboratorio se centra en los conceptos de este mdulo. Por ello,
podra no cumplir las recomendaciones de seguridad de Microsoft.

Requisitos previos Para trabajar en este laboratorio, es necesario tener:

Conocimientos sobre cmo generar una biblioteca de clases.
Conocimientos sobre cmo agregar una referencia a un proyecto.

Escenario Coho Winery ofrece varios beneficios a sus empleados. En los laboratorios de
este curso, crearemos un sitio Web que permita a los empleados seleccionar y
configurar los beneficios que elijan.
En este laboratorio, utilizaremos el seguimiento a travs de la ejecucin de la
aplicacin Web Benefits.
Tiempo estimado para
completar el laboratorio:
30 minutos
Ejercicio 0
Configuracin del laboratorio
Para realizar este laboratorio, es necesario haber creado el proyecto de la
aplicacin Web Benefits y el proyecto de la biblioteca de clases BenefitsList. Si
no se han creado estos proyectos, realizar los siguientes pasos:

Crear la solucin LabApplication

Importante Realizar este procedimiento nicamente si no se ha creado un

archivo de solucin LabApplication.

1. Utilizando Visual Studio .NET, crear una nueva solucin en blanco

denominada LabApplication:
a. En el men Archivo, seleccionar Nuevo, y hacer clic en Solucin en
blanco.
a. En el cuadro de dilogo Nuevo proyecto, escribir LabApplication en el
cuadro de texto Nombre y hacer clic en Aceptar.

Crear el proyecto Benefits

Importante Realizar este procedimiento nicamente si no se ha creado

anteriormente un proyecto Benefits t, o si se ha eliminado el proyecto Benefits
siguiendo los pasos del Apndice A, Recuperacin del laboratorio.

Crear un nuevo proyecto de aplicacin Web ASP.NET, denominado

BenefitsVB o BenefitsCS, en la solucin LabApplication:
En el men Archivo, seleccionar Nuevo, y hacer clic en Proyecto.
En el cuadro de dilogo Nuevo proyecto, en la lista Tipos de proyecto,
hacer clic en Proyectos de Visual Basic o Proyectos de Visual C#.
En la lista Plantillas, hacer clic en Aplicacin Web ASP.NET,
establecer la Ubicacin en http://localhost/BenefitsVB para un
proyecto Visual Basic .NET o en http://localhost/BenefitsCS para un
proyecto Visual C#.
Hacer clic en Agregar a Solucin, y hacer clic en Aceptar.

Precaucin Cuando se agregan proyectos a la solucin, es importante el uso de

maysculas en el nombre del proyecto. Probablemente, utilizaremos algunos
formularios Web Forms ya generados en ste y en otros laboratorios, y por ello,
debemos verificar que hemos escrito con mayscula el nombre del proyecto
Benefits. Pueden crearse dos versiones del proyecto: BenefitsVB sera una
solucin Visual Basic .NET y BenefitsCS sera una solucin Visual C#.
 Actualizar el proyecto Benefits
1. En Visual Studio .NET, abrir el archivo de solucin LabApplication.
2. En el Explorador de soluciones, hacer clic con el botn derecho en
BenefitsVB o BenefitsCS, seleccionar Agregar, y hacer clic en Agregar
elemento existente.
En el proyecto Microsoft Ir a la carpeta VB\Starter\BenefitsVB para los archivos de Visual Basic
Visual Basic .NET .NET.
En el cuadro Archivos de tipo del cuadro de dilogo Agregar elemento
existente BenefitsVB, hacer clic en Todos los archivos.
En el proyecto Visual C# Ir a la carpeta CS\Starter\BenefitsCS para los archivos de Visual C#.
En el cuadro Archivos de tipo del cuadro de dilogo Agregar elemento
existente BenefitsCS, hacer clic en Todos los archivos.
Estas carpetas se pueden encontrar dentro del fichero labs05.zip.
3. Seleccionar todos los archivos de la carpeta y hacer clic en Abrir.
4. Hacer clic en S a la pregunta de si sobrescribir o cargar de nuevo los
archivos.

Crear la biblioteca de clases BenefitsList

Importante Realizar estos pasos nicamente si no se ha creado anteriormente

un proyecto BenefitsList, o si se ha eliminado.

1. Crear un proyecto de biblioteca de clases con los nombres BenefitsListVB o

BenefitsListCS, y aadirlo a la solucin LabApplication.
a. En el men Archivo, seleccionar Nuevo, y hacer clic en Proyecto:
En el proyecto Visual En el cuadro de dilogo Nuevo proyecto, en la lista Tipos de proyecto,
Basic .NET hacer clic en Proyectos de Visual Basic.
En la lista Plantillas, hacer clic en Biblioteca de clases, establecer el
Nombre de BenefitsListVB.
Hacer clic en Agregar a solucin, y clic en Aceptar.

En el proyecto Visual C# En el cuadro de dilogo Nuevo proyecto, en la lista Tipos de

proyecto, hacer clic en Proyectos de Visual C#.
En la lista Plantillas, hacer clic en Biblioteca de clases, establecer el
Nombre de BenefitsListCS.
Hacer clic en Agregar a solucin, y clic en Aceptar.

Precaucin Verificar que se han escrito correctamente las maysculas del

proyecto BenefitsListVB o BenefitsListCS.
 Actualizar el proyecto BenefitsList
1. En Visual Studio .NET, abrir el archivo de solucin LabApplication.
2. En el Explorador de soluciones, hacer clic con el botn derecho en
BenefitsListVB o BenefitsListCS, seleccionar Agregar y hacer clic en
Agregar elemento existente.
3. Copiar los archivos de la carpeta Labfiles:
En el proyecto Visual a. Ir a la carpeta VB\Starter\BenefitsListVB.
Basic .NET
b. En el cuadro Archivos de tipo del cuadro de dilogo Agregar elemento
existente BenefitsListVB, hacer clic en Todos los archivos (*.*).
En el proyecto Visual C# a. Ir a la carpeta CS\Starter\BenefitsListCS.
b. En el cuadro Archivos de tipo del cuadro de dilogo Agregar elemento
existente BenefitsListCS, hacer clic en Todos los archivos (*.*).
Estas carpetas se pueden encontrar dentro del fichero labs05.zip.
4. Seleccionar todos los archivos de la carpeta y hacer clic en Abrir.
5. Hacer clic en S a la pregunta de si sobrescribir o cargar de nuevo los
archivos.

Crear una referencia al componente BenefitsList del proyecto Benefits

1. En el proyecto Benefits de la solucin LabApplication, completar los
siguientes pasos para agregar una referencia al componente BenefitsList que
acabamos de crear:
a. Hacer clic con el botn derecho en el proyecto BenefitsVB o BenefitsCS
en el Explorador de soluciones y hacer clic en Agregar referencia.
b. En el cuadro de dilogo Agregar referencia, en la pestaa Proyectos,
hacer doble clic en el proyecto BenefitsListVB o BenefitsListCS.
c. En la lista Componentes seleccionados, seleccionar el componente
BenefitsListVB o BenefitsListCS, y hacer clic en Aceptar.
El componente se agrega a la carpeta Referencias en el Explorador de
soluciones.
Ejercicio 1
Utilizar instrucciones de seguimiento
En este ejercicio, habilitaremos y deshabilitaremos el seguimiento y
agregaremos mensajes personalizados al resultado del seguimiento.

Habilitar el seguimiento en una pgina

1. En Visual Studio .NET, abrir la solucin LabApplication.
2. En el proyecto BenefitsVB o BenefitsCS, abrir el archivo default.aspx.
3. En la pgina default.aspx, cambiar a la vista Hypertext Markup Language
(HTML).
4. Modificar la directiva @ Page existente agregando un atributo Trace y
estableciendo su valor en true.
La directiva @ Page debera ser similar al siguiente cdigo, con la parte
aadida en negrita:
Visual Basic .NET <%@ Page Language="vb" AutoEventWireup="false"
Codebehind="default.aspx.vb"
Inherits="BenefitsVB._default" Trace="true" %>

C# <%@ Page Language="c#" AutoEventWireup="false"

Codebehind="default.aspx.cs"
Inherits="BenefitsCS._default" Trace="true" %>

5. Guardar default.aspx.
No es necesario generar la pgina, ya que no hemos cambiado nada del
cdigo. Los cambios a HTML nicamente requieren que se guarde la pgina.
6. Visualizar la pgina default.aspx en el navegador.
La informacin de seguimiento aparece en la parte inferior de la pgina.

Agregar mensajes de seguimiento personalizados

1. Ir al principio del procedimiento de evento Page_Load para la pgina
default.aspx, que se encuentra en la pgina de cdigo subyacente
default.aspx.vb o default.aspx.cs. Agregar un mensaje de seguimiento que
muestre el mensaje Beginning of Page_Load en una categora llamada
2310.
El cdigo debera ser similar al siguiente:
Visual Basic .NET Trace.Warn("2310", "Beginning of Page_Load")

C# Trace.Warn("2310", "Beginning of Page_Load");

2. En el procedimiento de evento Page_Load, inmediatamente debajo del

primer mensaje de seguimiento, agregar otro mensaje de seguimiento que
muestre el valor de la propiedad Page.IsPostBack.
El cdigo debera ser similar al siguiente:
Visual Basic .NET Trace.Warn("2310", "IsPostBack=" & Page.IsPostBack)

C# Trace.Warn("2310", "IsPostBack=" + Page.IsPostBack);

3. Generar y examinar la pgina default.aspx.
Deberamos visualizar los mensajes personalizados en la seccin Trace
Information, como muestra la siguiente ilustracin.

Utilizar seguimiento a nivel de aplicacin

1. Abrir el archivo life.aspx.vb o life.aspx.cs de los proyectos BenefitsVB o
BenefitsCS respectivamente.
2. En el procedimiento de evento Page_Load, agregar una instruccin de
seguimiento que reconoceremos fcilmente en el resultado de seguimiento.
Utilizar 2310 para la categora nos ser de ayuda para encontrar la
instruccin de seguimiento.
3. Generar y examinar la pgina life.aspx.
Se muestra la informacin de seguimiento en la pgina? Explicar por qu o
por qu no.
____________________________________________________________

____________________________________________________________

4. Abrir el archivo Web.config del proyecto Benefits y localizar el elemento

trace.
5. Generar una lista y a continuacin definir los atributos establecidos para el
elemento trace. Utilizar la documentacin de Visual Studio .NET para
descubrir las funcionalidades de los atributos.
_____________________________________________________________

_____________________________________________________________

6. En el archivo Web.config, habilitar el seguimiento a nivel de aplicacin

estableciendo el atributo enabled del elemento trace a true.
7. Visualizar de nuevo la pgina life.aspx en el navegador.
Se muestra la informacin de seguimiento en la pgina? Explicar por qu o
por qu no.
_____________________________________________________________

_____________________________________________________________

8. En el archivo Web.config, establecer el atributo pageOutput del elemento

trace a true.
9. Visualizar de nuevo la pgina life.aspx en el navegador.
Se muestra la informacin de seguimiento en la pgina? Explicar por qu o
por qu no.
_____________________________________________________________

_____________________________________________________________

Por qu se muestra la informacin de ese modo?

_____________________________________________________________

_____________________________________________________________
Ejercicio 2
Utilizar seguimiento en un componente
En este ejercicio, agregaremos instrucciones Trace al componente BenefitsList
invocado desde la pgina default.aspx.

Habilitar el seguimiento en el componente BenefitsList

1. En el proyecto BenefitsList, agregar una referencia a System.Web.dll
realizando los siguientes pasos:
a. En el proyecto BenefitsListVB o BenefitsListCS, hacer clic con el botn
derecho en la carpeta Referencias y hacer clic en Agregar referencia.
b. En el cuadro de dilogo Agregar referencia, en la ficha .NET, en la
lista de componentes, hacer doble clic en System.Web.dll, y en
Aceptar.
2. Abrir el archivo Class1:
En el proyecto Visual En el proyecto BenefitsListVB, abrir el archivo Class1.vb.
Basic .NET

En el proyecto Visual C# En el proyecto BenefitsListCS, abrir el archivo Class1.cs.

3. En el mtodo GetBenefitsList, habilitar el seguimiento estableciendo la
propiedad HttpContext.Current.Trace.IsEnabled a True.
El cdigo debera ser similar al siguiente:
Visual Basic .NET System.Web.HttpContext.Current.Trace.IsEnabled = True

C# System.Web.HttpContext.Current.Trace.IsEnabled = true;

Nota Tambin se puede insertar el comando Trace.IsEnabled en el constructor

de la clase si necesitamos realizar el seguimiento en todo el componente.

Agregar mensajes de seguimiento personalizados

1. Agregar un mensaje de seguimiento personalizado al mtodo
GetBenefitsList que muestra el mensaje Beginning of GetBenefitsList en
la categora denominada BenefitsList component.
El cdigo debera ser similar al siguiente:
Visual Basic .NET System.Web.HttpContext.Current.Trace.Warn _
("BenefitsList component", _
"Beginning of GetBenefitsList")

C# System.Web.HttpContext.Current.Trace.Warn
("BenefitsList component",
"Beginning of GetBenefitsList");
 2. Agregar otro mensaje de seguimiento al final del procedimiento (pero antes
del comando Return) que muestra el mensaje End of GetBenefitsList.
El cdigo debera ser similar al siguiente:
Visual Basic .NET System.Web.HttpContext.Current.Trace.Warn _
("BenefitsList component", _
"End of GetBenefitsList")

C# System.Web.HttpContext.Current.Trace.Warn
("BenefitsList component",
"End of GetBenefitsList");

Guardar y probar
1. Guardar los cambios del archivo Class1, y generar el proyecto.
2. Visualizar la pgina default.aspx en Microsoft Internet Explorer.
Deberamos visualizar nuestros mensajes personalizados desde la pgina y
desde el componente en la seccin Trace Information, como muestra la
siguiente ilustracin.

Por qu se invoca dos veces el mtodo GetBenefitsList?

_____________________________________________________________

_____________________________________________________________
 3. Abrir la pgina header.ascx.vb o header.ascx.cs.
4. En el procedimiento de evento Page_Load, agregar dos mensajes
Trace.Warn, ambos con un parmetro Category de Header:
a. Generar un mensaje al principio del procedimiento de evento, y
establecer Start Header como texto de mensaje.
b. Generar el segundo mensaje al final del procedimiento de evento
Page_Load, y establecer End Header como texto de mensaje.
El cdigo debera ser similar al siguiente:
Visual Basic .NET System.Web.HttpContext.Current.Trace.Warn _
("Header", "Start Header")
System.Web.HttpContext.Current.Trace.Warn _
("Header", "End Header")

C# System.Web.HttpContext.Current.Trace.Warn
("Header", "Start Header");
System.Web.HttpContext.Current.Trace.Warn
("Header", "End Header");

5. Generar y examinar default.aspx.

La informacin de seguimiento ahora incluye mensajes de seguimiento
Header, uno antes y otro despus del segundo conjunto de mensajes de
seguimiento BenefitsList Component.

Deshabilitar el seguimiento
1. Deshabilitar el seguimiento a nivel de aplicacin en Web.config.
2. Deshabilitar el seguimiento a nivel de pgina en la pgina default.aspx.
3. Deshabilitar los mensajes Trace.Warn en el evento Page_Load de
header.aspx.
4. Visualizar de nuevo la pgina default.aspx en el navegador.
Se muestra la informacin de seguimiento en la pgina? Explicar por qu o
por qu no
____________________________________________________________

____________________________________________________________

Si la informacin de seguimiento se muestra en la pgina, qu mensajes de

seguimiento personalizados se muestran? Por qu?
____________________________________________________________

____________________________________________________________
5. Eliminar o comentar los mensajes de seguimiento que hemos agregado en
este laboratorio, de acuerdo con la siguiente tabla.
Pgina Cdigo a eliminar

default.aspx.vb o default.aspx.cs Dos lneas en el procedimiento de evento

life.aspx.vb o life.aspx.cs
header.ascx.vb o header.ascx.cs
Class1.vb o Class1.cs
Page_Load.
Una lnea en el procedimiento de evento
Page_Load.
Una lnea al inicio del procedimiento de
evento Page_Load, y una lnea al final.
Tres lneas en el mtodo GetBenefitsList.

Al eliminar estas lneas de cdigo, las pginas no tendrn un aspecto

demasiado sobrecargado para futuros laboratorios.
6. Regenerar el proyecto Benefits (BenefitsVB o BenefitsCS) y el proyecto
BenefitsList (BenefitsListVB o BenefitsListCS).
7. Ir a default.aspx para verificar que los mensajes de seguimiento ya no se
muestran en la pgina.