Vous consultez une page technique concernant le logiciel de gestion Mercator. Celle-ci contient des informations spécifiques destinées aux professionnels de Mercator. Souhaitez-vous être redirigés vers des informations plus générales ?


   Ne plus poser cette question

Utilisation de l'API de Mercator dans le développement d'applications .Net

0000001369     -      08/10/2015

L'assembly MercatorTunnel.dll contient un espace de nom MercatorApi, reprenant une classe publique Api. Cette classe contient des méthodes statiques, c'est-à-dire qu'il n'est pas nécessaire d'instancier un objet de la classe Api pour pouvoir utiliser ces fonctions.

Les méthodes statiques disponibles sont :

  • AddBS : ajout d'un \ à la fin d'une chaîne de caractères si aucun \ ne termine cette chaîne
  • Asc : code ASCII d'une chaine contenant un caratère
  • Ask : boîte de dialogue pour la saisie d'une valeur
  • At : recherche de la position d'une sous-chaîne dans une chaîne de caractères (syntaxe identique à VFP)
  • RAt : recherche de la position inverse d'une sous-chaîne dans une chaîne de caractères (syntaxe identique à VFP)
  • BytesToString : conversion de bytes en string
  • Chr : chaine contenant un caractère déterminé par son code ASCII
  • ConvertMask : conversion d'un masque du format legacy vers Iformat accepté par ToString()
  • Crypt : cryptage d'une chaîne de caractères par une autre (renvoi sous forme de byte[])
  • CryptString : idem (renvoi sous forme de string)
  • FileToStr : chargement dans une variable du contenu d'un fichier
  • GetGuid = renvoi d'un GUID dans une chaîne de caractères
  • Ident : chaîne de 10 caractères de long généré de façon aléatoire
  • Iif : immédiate if
  • IsNull : teste si une chaine de caractères vaut null, si tel est le cas la remplace par une chaîne de substitution (par défaut, chaîne vide)
  • JustExt : extension d'un fichier existant
  • JustFName : nom de fichier d'un fichier existant
  • JustPath : chemin d'accès d'un fichier existant
  • JustStem : nom de fichier sans extension d'un fichier existant
  • MD5 : calcul d'une chaîne de caractères selon le codage MD5
  • Occurs : nombre d'occurrences d'une sous-chaîne dans une chaîne de carctères
  • Replicate : réplication d'une chaine de caractères n fois
  • Space : renvoi d'une chaîne contenant des espaces
  • Stop : affichage d'une simpe boîte de dialogue avec un message
  • StrExtract : remplacement d'une sous-chaîne dans une chaîne de caractères (syntaxe identique à VFP)
  • StrToFile : écriture du contenu d'une chaîne de caractères dans un fichier (syntaxe identique à VFP)
  • XencodeUrl : renvoi de l'encodage d'une URL (ex. : ->%3A)
  • XgetUrl : renvoi sous forme de chaîne du contenu d'un page HTML appelée via son URL
  • Xsha1: calcul d'une clé sha1 sur une chaîne de caractères
  • WaitMessage : affichage d'un message tel que celui produit wait ... window nowait de VFP
  • WaitClear : suppression de la fenêtre WaitMessage
  • WebNavigate : démarrage d'une instance d'Internet Explorer vers une URL
  • Zselect : obtention d'un dataset sur base d'une requête SQL et de paramètres de connexion
  • ...

(Bien entendu, cette liste sera enrichie au gré de l'évolution des développements)

Dans un code en C#, il suffit donc d'ajouter une référence vers MercatorTunnel .dll et ensuite d'indiquer la clause "using MercatorApi", pour pouvoir disposer de ces fonctions.

Exemple d'utilisation de ces méthodes :
 

Zoom
String My_pict = Api.ConvertMask("999 999 999.99");