 | Cette information est obsolète. Les développements de sites web autour de Mercator se font maintenant |
Le principe de base d'utilisation est simple. Il suffit d'abord d'ajouter une référence vers MercatorIshopAspx.dll. Dans Visual Studio, sélection "Ajouter une référence" dans le menu "Website". Ensuite, via l'onglet "Parcourir" localiser "MercatorIshopAspx.dll". (N'oubliez pas que la dernière version de MercatorTunnel.dll doit être présente dans le même répertoire)
Ensuite, dans la page ASPX, il faut ajouter sous la première ligne :
<%@ Import Namespace="MercatorIshopNs" %> Si l'espace de nom MercatorIshop doit être utilisé dans dans la partie "code" de cette page ASPX, on peut ajouter dans le fichier .cs (par exemple pour C#) :
Using MercatorIshopNs; Enfin, dans la page ASPX, il suffit de placer dans le body (ici exemple pour ShowPage)
<%Response.Write(MercatorIshop.ShowPage());%> (Notez qu'une fois saisi MercatorIshop, une liste avec l'ensemble des méthodes disponibles est présentée par Visual Studio.
MercatorIshop.ShowPage() renverra une chaîne de caractère correspondant à ce qui est paramétré dans MercatorIshop.exe dans la source HTML de la page correspondante, à savoir ici ShowPage. Si dans MercatorIshop, les tags <html><body></body></html> sont présents, il faut veiller à ce qu'ASP.net ne les renvoie pas aussi. Ceci peut se faire avec cette ligne de commande (qui remplace la précédente) :
<%Response.ClearContent(); Response.Write(MercatorIshop.ShowPage()); Response.End(); %> Une bonne stratégie serait évidemment de paramétrer MercatorIshop pour que les tags <html><body></body></html> ne soient pas renvoyés par MercatorIshop et puissent donc être gérés par ASP.net. En persévérant dans ce concept, il est donc conseillé que le contenu renvoyé par MercatorIshop soit le plus court possible. Dans la majorité des cas, il devra se limiter à la partie calculée par MercatorIshop, à savoir %FOX%.
Dans l'exemple repris ci-dessus, aucun paramètre n'a été passé lors de l'appel de MercatorIshop.ShowPage(). Toutefois, chaque méthode de la classe managée accepte aussi un paramètre de type string. Ce paramètre doit être construit selon la syntaxe d'une query string passé dans une URL. Exemple :
parametre1=valeur1¶metre2=valeur2 Dès lors, il est possible d'appeler la méthode ShowPage comme suit :
<%Response.Write(MercatorIshop.ShowPage("page=test&coucou=gamin"));%> Si aucun paramètre n'est passé à cette méthode (comme dans notre premier exemple), alors MercatorIshopAspx.dll utilise le query string de la page ASPX en cours. Par exemple: si la page en cours est http://myhost/mysite/ShowPage.aspx?page=test&coucou=gamin, alors le paramètre qui sera en définitive passé à MercatorIshop est bien page=test&coucou=gamin
Le fichier Zip ci-joint contient l'exemple de page ShowPage.aspx.
Remarque : l'espace de noms MercatorIshopPoolNs contient le pool manager d'instances de MercatorIshop. Les classes contenues dans cet espace de noms ne doivent jamais être utilisées dans la programmation ASP.net. Elles sont à disposition de la classe MercatorIshop seulement.
A télécharger :
0000001479.zip (0 Kb - 26/03/2008)