Cursus ASP.net : ASP.net pagina's in detail

ASP.net pagina's uitvoeren

Wanneer een browser een ASP.NET pagina opvraagt herkent IIS de aspx-extensie en laat de ASP.NET module aspnet_isapi.dll de vraag verder afhandelen. De aspnet_isapi.dll plaatst het aspx-bestand in een nieuwe klasse-definitie in de namespace ASP. Mijnpagina.aspx wordt een ASP.mijnpagina_aspx klasse. Deze klasse erft van de Page klasse uit de System.Web.UI namespace. Elke ASP.NET webpagina die wordt opgevraagd wordt in feite gecompileerd tot een klasse die erft van de .NET Page-klasse en dus alle functionaliteit van deze klasse kan gebruiken.

Events bij het uitvoeren van ASP.net pagina's

ASP.NET is event-driven : code wordt uitgevoerd wanneer bepaalde acties worden ondernomen. Deze acties worden gestart door een gebruiker of automatisch binnen het .NET Framework.

De volgorde waarin events uitgevoerd worden bij het laden van elke pagina noemen we de life cycle:

Event	Omschrijving
Page Setup	Hier wordt een tree van controls opgebouwd en gedetecteerd waarom de pagina moet uitgevoerd worden: een normaal request, een postback, een cross-page postback of een callback. De collectie gegevens ontvangen via POST of GET wordt voorbereid. Na deze stap kunnen we op events sturen naar de eventhandlers in de broncode.
PreInit	Geïntroduceerd in ASP.Net 2.0: het beginpunt in de levenscyclus van een pagina. Wanneer dit event wordt uitgevoerd zijn nog geen masterpage of theme geassocieerd. De scroll-positie is gekend, geposte data is beschikbaar en de controls werden geïnitialiseerd met de eigenschappen zoals opgegeven in de aspx-broncode. Controls hebben geen ID als dit niet in de aspx-code is opgegeven. Masterpage of theme opgeven is vanaf nu mogelijk via code. IsPostBack, IsCrossPagePostBack en IsCallBack worden hier ingesteld.
Init	Masterpage en theme zijn ingesteld en kunnen niet meer worden veranderd. Alle child controls zien hun OnInit methode uitgevoerd. De ViewState is nog niet herzet.
InitComplete	Geïntroduceerd in ASP.Net 2.0: controls halen hun ViewState op. Alles wat voor dit event in de ViewState geschreven is zal verloren gaan bij de volgende PostBack
PreLoad	Geïntroduceerd in ASP.Net 2.0: enkel voor pagina's: aangeven dat de pagina de systeemniveau-initialisatie heeft voleindigd en nu de aandacht kan geschonken worden aan de gebruikerscode
Page_Load	Eerst uitgevoerd voor de pagina, daarna voor alle controls. Wanneer de pagina geladen is, de __Viewstate is nu volledig geladen en kan zonder probleem benaderd worden.
PostBack afhanelen	Het PostBack-mechanisme is het hart van ASP.Net programmeren. Het bestaat uit het versturen van formuliergegevens naar dezelfde pagina en het gebruiken van de viewstate om de oproepcontext te construeren.
Control Event	Wanneer een control een event heeft geraised, zoals wanneer een druk op een knop de pagina heeft herladen
LoadComplete	Geïntroduceerd in ASP.Net 2.0: enkel voor de pagina: duidt het einde aan van de paginavoorbereidingsfase, hierna wordt de pagina afgewerkt: Page Rendering
Pagina-afwerking	De pagina is klaar om output naar de browser te sturen
PreRender	Pagina's en Controls kunnen hier updates ondergaan vooraleer de output wordt gegenereerd
PreRenderComplete	Geïntroduceerd in ASP.Net 2.0: geeft aan dat de PreRender-fase voor alle controls voleindigd is
SaveStateComplete	De nieuwe toestand van de controls wordt opgeslagen in de viewstate
Page_Unload	Wanneer de pagina uit het server-geheugen wordt gehaald, eerst voor alle controls, daarna voor de pagina.

De eigenschap Request

Wanneer een browser een request voor een pagina geeft, wordt de informatie die de browser naar de server stuurt netjes door het .NET Framework gebundeld in een HttpRequest.
Dit object kan je vanuit de Page-klasse aanspreken met de eigenschap Request.

De request informatie kan je gebruiken om informatie te weten over de browser, cookie-informatie op te vragen,...

De eigenschap Response

Het Page-object dat we maken door een aspx-pagina op te vragen heeft een eigenschap Response. Deze eigenschap bevat in feite een object van de klasse HttpResponse. Dit object heeft een aantal interessante methoden en eigenschappen:

Redirect: de browser naar een andere pagina sturen - de formulierinformatie wordt NIET meegestuurd
```
Response.redirect("http://www.ivobrugge.be");
```
Write: tekstgegevens naar de browser sturen

De eigenschap IsPostBack

Deze eigenschap van de klasse Page bevat een Boolean waarde die aangeeft of de pagina werd teruggepost naar de server. Hiermee kan je controleren of een pagina voor het eerst wordt getoond of er reeds een terugpost naar de server is geweest doordat de gebruiker bv. op een knop heeft gedrukt.
Deze eigenschap zal in de rest van de cursus vaak worden gebruikt.

Voorbeeld

In dit voorbeeld wordt een ArrayList gebruikt om een ListBox te vullen. We zorgen er voor dat deze ArrayList slechts één keer gebruikt wordt om de ListBox te vullen : de eerste keer dat de pagina wordt getoond. Wanneer de gebruiker de pagina verstuurd gebreurt een postback, de formulierelementen behouden hun 'state' door het verborgen Viewstate - formulierveld. Hierdoor hoef je de ArrayList geen tweede keer te gebruiken.

Deze techniek zal vaak aangewend worden wanneer keuzelijsten e.d. gevuld worden met gegevens uit een database. Zo is er slechts één keer een dataconnectie nodig.

IsPostback.aspx
...
<form id="form1" runat="server">
<div>
    <asp:ListBox ID="LBdieren" runat="server" AutoPostBack="True"></asp:ListBox>
    <br />
    <br />
    <asp:Label ID="LblKeuze" runat="server" Text="Label"></asp:Label>
</div>
</form>
...

IsPostback.aspx.cs
...

protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            ArrayList dieren = new ArrayList();
            dieren.Add("Kat");
            dieren.Add("Hond");
            dieren.Add("Aap");
            dieren.Add("Ezel");
            dieren.Add("Giraf");

            dieren.Sort();

            LBdieren.DataSource = dieren;
            LBdieren.DataBind();
        }
        else
        {
            LblKeuze.Text = "Je koos een " + LBdieren.SelectedItem.Text;
        }

    }

De eigenschap Context

De eigenschap Context bevat alle http-informatie aangaande een http-request. De eigenschap Context bevat een instantie van de klasse System.Web.HttpContext. Dit object heeft een aantal interessante members.

De eigenschap Context kan je gebruiken om informatie bij te houden wanneer de gebruiker naar een andere pagina wordt gestuurd. Niets is vervelender voor jouw als programmeur en voor de gebruiker dat dezelfde informatie meermaals moet worden verstrekt.

member	omschrijving
Session	Bevat een HttpSessionState-object waarmee je informatie van een bepaalde gebruiker (sessie) kan bewaren. Je kan de informatie per gebruiken in key/value paren.
Application	evat een HttpApplicationState-object waarmee je informatie voor alle gerbuikers kan bewaren. Je kan de informatie in key/value paren opslaan.
Items	Collectie met key/value paren die informatie bewaren van alle componenten die deelnemen in één http-request. Deze collectie is dus slechts gekend gedurende één request van de gebruiker. Met Server.Transfer kan je de gegevens wel meegeven. Klikt de gebruiker echter op een hyperlink of ga je met Response.Redirect naar een andere pagina van de site, dan gaat deze informatie verloren.
Handler	Levert je informatie over de pagina die opgevraagd wordt, maar stelt je ook in staat om informatie over de aanvrager op te vragen na bijvoorbeeld Server.Transfer
Trace	Geeft je de mogelijkheid het uitvoeren van je toepassing te traceren en te zien waar 'bottlenecks' zich bevinden

In het bestand Global.asax kan je code schrijven voor onder meer volgende event-handlers:

event-handler	omschrijving
Application_Start	Wordt uitgevoerd wanneer de applicatie wordt opgestart: onze toepassing voorbereiden op het ontvangen van requests, zoals databaseconnecties openen, applicatievariabelen instellen, ...
Session_Start	Wanneer een sessie start: een gebruiker betreedt de site
Session_End	Een gebruiker verlaat de toepassing
Application_End	De applicatie wordt afgesloten
Application_BeginRequest	Bij elke request
Application_EndRequest	Na elk request
Application_Error	Afhandelen van onverwachte fouten

Het bestand Global.asax moet zich in de root van de virtuele map in IIS bevinden.

Voorbeeldtoepassing

We maken een kleine toepassing die het werken met contextitems, sessievariabelen en applicatievariabelen demonstreert.

We maken een aspx pagina waarin we in het Load-event van het formulier een contextitem-, twee sessievariabelen en een applicatievariabele vulllen.

We voorzien ook twee knoppen, bij het klikken op een knop wordt de gebruiker doorgestuurd naar een andere pagina. Het doorsturen gebeurt een keer met Response.Redirect en een keer met Server.Transfer (zie volgend onderdeel in de cursus).

Op de tweede pagina plaatsen we vier labels die de inhoud van deze variabelen moeten tonen. We gaan telkens na of er een fout optreedt.

	*Met Server.Transfer*
	*Met Response.Write*

Toon /verberg code

Content.aspx
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Context.aspx.cs" Inherits="Context" %>

<!DOCTYPE html PUBLIC "-//W3C//Dtd XHTML 1.0 Transitional//EN" "http://www.w3.org/tr/xhtml1/Dtd/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <table id="Table1" cellspacing="1" cellpadding="1" width="440" border="1" style="WIDTH: 440px; HEIGHT: 124px">
				<tr>
					<td style="WIDTH: 102px">Items</td>
					<td>item1</td>
					<td>
						<asp:Label id="Label1" runat="server" 
						Width="158px" BorderStyle="Solid" 
						BorderWidth="1px" BackColor="#C0FFC0"
						ForeColor="Maroon"></asp:Label></td>
				</tr>
				<tr>
					<td style="WIDTH: 102px">Session</td>
					<td>sessie1</td>
					<td>
						<asp:Label id="Label2" runat="server"
						Width="156px" BorderStyle="Solid" 
						BorderWidth="1px" BackColor="#C0FFC0"
						ForeColor="Maroon"></asp:Label></td>
				</tr>
				<tr>
					<td style="WIDTH: 102px">Application</td>
					<td>app1</td>
					<td>
						<asp:Label id="Label3" runat="server"
						Width="156px" BorderStyle="Solid" 
						BorderWidth="1px" BackColor="#C0FFC0"
						ForeColor="Maroon"></asp:Label></td>
				</tr>
				<tr>
					<td style="WIDTH: 102px">Session 2</td>
					<td>lijstitem</td>
					<td>
						<asp:Label id="Label4" runat="server" 
						Width="156px" BorderStyle="Solid" 
						BorderWidth="1px" BackColor="#C0FFC0"
						ForeColor="Maroon"></asp:Label></td>
				</tr>
			</table>
			<p><asp:Button id="btnLaadTweede" runat="server" Text="Transfer" OnClick="btnLaadTweede_Click"></asp:Button> 
				<asp:Button id="btnRedirect" runat="server" Text="Redirect" OnClick="btnRedirect_Click"></asp:Button></p>
    </div>
    </form>
</body>
</html>

Context.aspx.cs
private void Page_Load(object sender, System.EventArgs e)
		{
			Context.Items["item1"] = "Inhoud item1";
			Context.Session["sessie1"] = "Inhoud sessie1";
			Context.Application["app1"] = "Inhoud app1";

			ArrayList lijst = new ArrayList();
			lijst.Add("aap");
			lijst.Add("hond");
			lijst.Add("kat");

			Context.Session["lijst"] = lijst;

			Label1.Text = Context.Items["item1"].ToString();
			Label2.Text = Context.Session["sessie1"].ToString();
			Label3.Text = Context.Application["app1"].ToString();
			Label4.Text = lijst[1].ToString();
		}
		
private void btnLaadTweede_Click(object sender, System.EventArgs e)
		{
			Server.Transfer("Context_deel2.aspx");
		}

private void btnRedirect_Click(object sender, System.EventArgs e)
		{
			Response.Redirect("Context_deel2.aspx");
		}

		
		
		
Context_deel2.aspx
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Context_deel2.aspx.cs" Inherits="Context_deel2" %>

<!DOCTYPE html PUBLIC "-//W3C//Dtd XHTML 1.0 Transitional//EN" "http://www.w3.org/tr/xhtml1/Dtd/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Context: tweede pagina</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <table id="Table1" style="WIDTH: 440px; HEIGHT: 124px" cellspacing="1" cellpadding="1"
					width="440" border="1">
					<tr>
						<td style="WIDTH: 102px">Items</td>
						<td>item1</td>
						<td>
							<asp:Label id="Label1" runat="server"
							ForeColor="Maroon" BackColor="#C0FFC0" 
							BorderWidth="1px"
							BorderStyle="Solid"
							Width="158px"></asp:Label></td>
					</tr>
					<tr>
						<td style="WIDTH: 102px">Session</td>
						<td>sessie1</td>
						<td>
							<asp:Label id="Label2" runat="server"
							ForeColor="Maroon" BackColor="#C0FFC0"
							BorderWidth="1px" BorderStyle="Solid"
							Width="156px"></asp:Label></td>
					</tr>
					<tr>
						<td style="WIDTH: 102px">Application</td>
						<td>app1</td>
						<td>
							<asp:Label id="Label3" runat="server"
							ForeColor="Maroon" BackColor="#C0FFC0"
							BorderWidth="1px" BorderStyle="Solid"
							Width="156px"></asp:Label></td>
					</tr>
					<tr>
						<td style="WIDTH: 102px">Session 2</td>
						<td>lijstitem</td>
						<td>
							<asp:Label id="Label4" runat="server"
							ForeColor="Maroon" BackColor="#C0FFC0"
							BorderWidth="1px" BorderStyle="Solid"
							Width="156px"></asp:Label></td>
					</tr>
				</table>
    </div>
    </form>
</body>
</html>


Context_deel2.aspx.cs
private void Page_Load(object sender, System.EventArgs e)
		{
			try
			{
				Label1.Text = Context.Items["item1"].ToString();
			}
			catch(Exception ex)
			{
				Label1.Text = "Fout: " +ex.Message;
			}

			try
			{
				Label2.Text = Context.Session["sessie1"].ToString();
			}
			catch(Exception ex)
			{
				Label2.Text = "Fout: " +ex.Message;
			}

			try
			{
				Label3.Text = Context.Application["app1"].ToString();
			}
			catch(Exception ex)
			{
				Label3.Text = "Fout: " +ex.Message;
			}

			try
			{
				ArrayList l = (ArrayList)Context.Session["lijst"];
				Label4.Text = l[2].ToString();
			}
			catch(Exception ex)
			{
				Label3.Text = "Fout: " +ex.Message;
			}
			
			
		}

Je merkt dat bij het versturen met Response.Write de informatie in contextitems niet meer wordt onthouden.

Uit deze toepassing valt het verschil tussen sessie- en applicatievariabelen niet uit te maken. Onthoud dat sessievariabelen een set variabelen vormen voor elke individuele user, applicatievariabelen vormen een set gemeenschappelijke variabelen voor alle gebruikers.

De eigenschap Server

De eigenschap Server van de klasse Page bevat een object van de klasse System.Web.HttpServerUtility waarmee je toegang hebt tot een arsenaal aan interessante eigenschappen en methodes om de webserver te manipuleren.

member	omschrijving
MapPath	Retourneert het fysieke pad op de server van de huidige virtuele map. Kan handig gebruikt worden voor het openen en opslaan van bestanden op de server
HtmlEncode	Encodeert een string voor weergave in een browser
Transfer	Beëindigt de uitvoering van de huidige pagina en begint de uitvoering van een andere pagina. In tegenstelling tot bij Response.Write kan je na een transfer wel nog aan de elementen van de bronpagina!
Execute	Voer een andere pagina uit en ontvang eventueel de gegenereerde output in de huidige pagina
MachineName	Retourneert de naam van de servercomputer

Voorbeeldtoepassing

In deze toepassing leer je hoe je na een Transfer aan de gegevens van de bronpagina kan opvragen. Je maakt ook kennis met de methode Execute.

Maak een pagina met daarin een TextBox en een Button. Voorzie in de codebehind-file een property Voornaam.

Bij klikken op de knop voorzie je dat de gebruiker met Server.Transfer wordt doorgestuurd naar een tweede pagina.

Op de tweede pagina kunnen we de inhoud van de TextBox en de waarde van de Property van de eerste pagina opvragen!
Daarvoor gebruiken we de eigenschap Handler van de Context (HttpContext) van de pagina. De ontvangen gegevens typecasten we naar de klasse van de originele pagina.
Een control kunnen we nu vinden met de methode FindControl
Een property kunnen we rechtstreeks aanspreken

De methode Execute staat je toe een externe pagina uit te voeren. Deze pagina kan uitvoercommando's bevatten (controles, wegschrijven in een database, ...), je kan met behulp van een TextWriter ook eventuele respons-informatie van de uitgevoerde pagina opvangen. We geven de opgevraagde waarde weer met behulp van drie Labels.

Toon /verberg

ServerMethoden.aspx
<asp:TextBox ID="Txtinvul" runat="server"
	></asp:TextBox>
<asp:Button ID="BtnVerstuur" runat="server" 
	OnClick="BtnVerstuur_Click" Text="Button" />
	
ServerMethdoden.aspx.cs
public string Voornaam
{
   get
   {
       return "William";
   }
}

protected void Page_Load(object sender, EventArgs e)
{
}

protected void BtnVerstuur_Click(object sender, EventArgs e)
{
    Server.Transfer("ServerMethoden_deel2.aspx");
}

ServerMethoden_deel2.aspx
<asp:Label ID="LblControl" runat="server" Text="Label"></asp:Label>
<br />
<asp:Label ID="LblProperty" runat="server" Text="Label"></asp:Label>
<br />
<asp:Label ID="LblExecute" runat="server" Text="Label"></asp:Label>

ServerMethoden_deel2.aspx.cs
protected void Page_Load(object sender, EventArgs e)
{
    ServerMethoden origineel = (ServerMethoden)Context.Handler;
    LblControl.Text = ((TextBox)origineel.FindControl("TxtInvul")).Text;
    LblProperty.Text = origineel.Voornaam;

    StringWriter sw = new StringWriter();
    Server.Execute("ServerMethoden_uitvoeren.aspx", sw);
    LblExecute.Text = sw.ToString();
}

ServerMethoden_uitvoeren.aspx
<%= "Commando's zijn uitgevoerd ! " %>

Page Directives

Wanneer een pagina gemaakt wordt kan je een aantal attributen opnemen in deze pagina. Deze attributen kan je instellen via directives. Een aantal hiervan komen later in de cursus meer in detail aan bod.

Directive	Beschrijving
@Assembly	Hiermee kan je een assembly in je pagina importeren (.dll-bestand)
@Control	Definieert een attribuut specifiek voor een control
@Implements	Stelt je in staat een interface in je webpagina te importeren. Hierdoor geef je aan dat je webpagina de in een interface gedefiniëerde eigenschappen, methoden en events zal gebruiken
@Import	Hiermee kan je een namespace importeren in de pagina. Dit zorgt ervoor dat alle klassen en interfaces binnen die namespace bruikbaar zijn binnen de pagina. Het .NET Framework importeert standaar een heel aantal namespaces voor jou
@Master	Identificeert een Master Page (niet beschikbaar in .Net 1.1)
@Outputcache	Hiermee kan je instellen hoe de pagian gecached wordt op de server
@Page	Een derictive die we al vaak hebben gebruikt is de @Page directive. Hiermee hebben we een attribuut language ingesteld om aan te geven welke .NET taal we wensen te gebruiken
@Reference	Wordt gebruikt om een pagina of user control in de pagina te importeren. Op deze manier wordt de pagina of usrer control runtime gelilnked
@Register	Hiermee kan je server controls die je eventueel zelf hebt ontworpen in de pagina importeren met een specifieke tag (prefix en naam)

ASP.net : ASP.net pagina's in detail

Inleiding

Een ASP.Net pagina uitvoeren

Compilatie

System.Web.UI.Page: overzicht

ASP.net pagina's uitvoeren

Events bij het uitvoeren van ASP.net pagina's

De eigenschap Request

De eigenschap Response

De eigenschap IsPostBack

Voorbeeld

De eigenschap Context

Voorbeeldtoepassing

De eigenschap Server

Voorbeeldtoepassing

Page Directives