ASP en HTML commentaar (in ASP)

Door Michiel van Otegem
20 september 2001

Het is altijd goed om commentaar in je code te zetten over wat het doet. Bij simpele code is dit misschien wat overdreven, maar als je complexe code aan het schrijven bent, waarbij iets gebeurt dat niet meteen uit de code te herleiden is, dan is het absoluut aan te raden commentaar te gebruiken. Niet alleen voor anderen die je code kunnen lezen, maar ook voor jezelf. Het is heel goed mogelijk dat je je niet meer kunt herinneren hoe je iets zes maanden geleden gedaan hebt.

Je code van commentaar voorzien kan op verschillende manieren. Allereerst kan je het commentaar toevoegen aan de HTML, buiten de ASP <% en %>, of <script> blokken. Je kan dit commentaar als volgt toevoegen:

<!--dit is HTML commentaar-->

<!--dit is HTML commentaar
en beslaat meerdere regels
-->

In ASP kan je ook commentaar toevoegen, maar op verschillende manieren. Het eerste type commentaar is het commentaar dat in de script taal gevoegd kan worden die je gebruikt. In VBScript wordt commentaar voorafgegaan door ', en in JScript wordt het voorafgegaan door //, of bijgevoegd in /* en */. Zoals wordt getoond in de voorbeelden hieronder.

<%@ Language=VBScript %>
<%
'dit is VBScript commentaar
%>

<%@ Language=JScript %>
<%
//dit is JScript commentaar

/*
dit zijn meerdere regels
JScript commentaar
*/
%>

Wat je misschien niet weet is dat je ook HTML commentaar kan gebruiken binnen blokken ASP code! Dus het volgende werkt:

<%
<!--dit is HTML commentaar binnen ASP-->

<!--dit is HTML commentaar binnen ASP
en beslaat meerdere regels
-->
%>

Het HTML commentaar binnen de ASP code levert geen foutmelding op, de code blijft gewoon werken zoals het hoort. Het wordt ook niet getoond in de browser. Als je echter <script runat="server"> blokken gebruikt, wordt het commentaar naar de browser geschreven alsof het HTML commentaar buiten ASP is. Hoe ASP.NET hier mee omgaat is iets waar ik een andere keer op in zal gaan.