 | Deze informatie is verouderd. De ontwikkelingen van websites rond Mercator websites zijn nu gedaan |
Het basisgebruiksprincipe is eenvoudig. Het volstaat in eerste instantie een verwijzing naar MercatorIshopAspx.dll toe te voegen. In Visual Studio selecteert u "Verwijzing toevoegen" in het menu "Website". Vervolgens lokaliseert u via het tabblad "Bladeren" het bestand "MercatorIshopAspx.dll" (vergeet niet dat de meest recente versie van MercatorTunnel.dll in diezelfde directory moet staan).
Vervolgens voegt u op de pagina ASPX onder de eerste lijn het volgende toe:
<%@ Import Namespace="MercatorIshopNs" %> Als de MercatorIshop-namenruimte moet worden gebruikt in het "code"-gedeelte van deze ASPX-pagina, kunt u in het bestand .cs het volgende toevoegen (bijvoorbeeld voor C#):
Using MercatorIshopNs; Tot slot plaatst u in de body van de ASPX-pagina (hier voorbeeld voor ShowPage):
<%Response.Write(MercatorIshop.ShowPage());%> (opm.: eens u MercatorIshop hebt ingevoerd, geeft Visual Studio een lijst weer met alle beschikbare methodes.
MercatorIshop.ShowPage() zal een tekenreeks terugsturen die overeenkomt met wat er in MercatorIshop.exe in de html-broncode van de respectieve pagina is geparametreerd, namelijk hier ShowPage. Als in MercatorIshop de tags <html><body></body></html> voorkomen, moet u ervoor zorgen dat ASP.net ze niet ook terugstuurt. Daartoe gebruikt u deze commandoregel (die de voorgaande vervangt):
<%Response.ClearContent(); Response.Write(MercatorIshop.ShowPage()); Response.End(); %> Een goede strategie zou ook zijn om MercatorIshop zodanig in te stellen dat de tags <html><body></body></html> niet worden teruggestuurd door MercatorIshop en dus beheerd kunnen worden door ASP.net. Terwijl u in dit concept volhardt, raden we ook aan om de door MercatorIshop teruggestuurde content zo kort mogelijk te houden. In de meeste gevallen zou die zich moeten beperken tot het door MercatorIshop berekende gedeelte, namelijk %FOX%.
In het bovenstaande voorbeeld werd geen enkele parameter ingevoerd bij de oproep van MercatorIshop.ShowPage(). Toch aanvaardt elke methode van de beheerde klasse ook een parameter van het type string. Deze parameter moet worden opgesteld volgens de structuur van een in een URL ingevoerde query string. Bijvoorbeeld:
parametre1=valeur1¶metre2=valeur2 Vandaar dat het ook mogelijk is om de ShowPage-methode als volgt op te roepen:
<%Response.Write(MercatorIshop.ShowPage("page=test&coucou=gamin"));%> Als bij deze methode geen enkele parameter wordt ingevoerd (zoals in ons eerste voorbeeld), gebruikt MercatorIshopAspx.dll de query string van de actieve ASPX-pagina. Bijvoorbeeld: als de actieve pagina = http://myhost/mysite/ShowPage.aspx?page=test&coucou=gamin, zal de parameter die uiteindelijk in MercatorIshop wordt ingevoerd = page=test&coucou=gamin.
Het bijgevoegde zipbestand bevat het voorbeeld van ShowPage.aspx.
Opmerking: de namenruimte MercatorIshopPoolNs bevat de procespoolbeheerder van MercatorIshop. De klassen die zich in deze namenruimte bevinden, mogen nooit worden gebruikt bij de ASP.net-programmering. Ze zijn enkel bestemd voor de MercatorIshop-klasse.
Te laden :
0000001479.zip (0 Kb - 26-03-2008)