Utilisation de la bibliothèque .Net de l'IMu

Le bundle de code source de l’API IMu .Net pour la version 2.0 (ou supérieure) est nécessaire pour développer une application basée sur IMu. Ce bundle contient toutes les classes qui composent l’API IMu .Net. Contactez l’assistance Axiell pour obtenir l’accès aux bundles de l’API IMu.

Comme pour toutes les assemblies .Net, l’assembly .Net IMu doit être disponible afin que le compilateur .Net et l’environnement d’exécution puissent trouver et utiliser les classes IMu. Les outils de développement .Net, tels que Visual Studio de Microsoft, permettent d’ajouter une référence à l’assembly IMu à un projet. Toutes les classes de l’API .Net IMu sont incluses dans le seul espace de noms, IMu. Comme c’est habituellement le cas dans le développement .Net, il est possible de faire référence à une classe IMu dans votre code de l’une des manières suivantes :

  1. En utilisant le nom complet :

    C#

    IMu.Session session = new IMu.Session();

    VB

    Dim session = New IMu.Session()

  2. Importation de l’espace de noms :

    C#

    usingIMu;
    // ⋯
    Session session = new Session();

    VB

    Imports IMu
    ' ⋯
    Dim session = New Session()

Programme de test

La compilation et l’exécution de ce programme IMu très simple basé sur une console constituent un bon test pour vérifier si l’environnement de développement a été correctement configuré pour utiliser IMu :

C#

using System; using IMu; class Hello { static void Main(string[] args) { Console.WriteLine("IMu Version {0}", IMu.IMu.VERSION); Environment.Exit(0); } }

VB

Imports IMu Module Hello    Sub Main() Console.WriteLine("IMu Version {0}", IMu.IMu.VERSION) Environment.Exit(0) End Sub End Module

La bibliothèque IMu comprend une classe appelée IMu. Cette classe comprend le membre statique string VERSION qui contient la version de cette distribution d’IMu.

Exceptions

De nombreuses méthodes des objets de la bibliothèque IMu lèvent une exception lorsqu’une erreur se produit. Pour cette raison, le code qui utilise des objets de bibliothèque IMu doit être entouré d’un bloc try / catch.

Le code suivant est un modèle de base pour écrire des programmes .Net qui utilisent la bibliothèque IMu :

C#

using IMu; // ⋯ try { // Créer et utiliser des objets IMu // ⋯ } catch (Exception e) {  // Gérer ou signaler l'erreur // ⋯ }

VB

Imports IMu ' ⋯ Try ' Créer et utiliser des objets IMu ' ⋯ Catch ex As Exception ' Gérer ou signaler l'erreur ' ⋯ End Try

La plupart des exceptions IMu sont des objets IMuException. La classe IMuException est une sous-classe de la classe standard Exception de .Net. Dans de nombreux cas, votre code peut simplement intercepter l’exception standard Exception (comme dans ce modèle). Si davantage d’informations sont nécessaires au sujet de l’exception IMuException exacte qui a été levée, consultez la rubrique Exceptions.

Note: La plupart des exemples qui suivent supposent que les fragments de code sont entourés de code structuré de cette manière.