1. Ouvrez le projet WINDEV à partir duquel l'assemblage .NET doit être créé.
   Ce projet doit contenir tous les éléments nécessaires à l'assemblage .NET. Ce projet peut par exemple contenir une ou plusieurs procédures globales ou/et classes, contenant diverses méthodes. Ces méthodes et / ou procédures seront les points d'entrées de l'assemblage.
   Remarque : Lorsque vous créez des assemblages .NET destinés à être utilisés sous d'autres environnements, il est conseillé de les documenter. Cette documentation est automatiquement générée par WINDEV.
2. Créez si nécessaire une configuration de projet de type "Assemblage .NET" : sous le volet "Projet", dans le groupe "Configuration de projet", déroulez "Nouvelle configuration" et sélectionnez "DLL d'assemblage .NET". Dans l'assistant, spécifiez :
   • le nom et la description de la configuration de projet.
   • les éléments intégrés dans la configuration de projet.
   • Validez. La configuration de projet est créée avec les éléments nécessaires.
3. Parmi les boutons d'accès rapide, cliquez sur pour générer l'assemblage ".NET". L'assistant de création d'un assemblage .NET se lance.
4. Indiquez les propriétés de l'assemblage .NET que vous allez créer : nom du ficher, société, description, copyright, etc.
   
   
   Le bouton "Avancé" reprend les propriétés indiquées et permet de définir des propriétés supplémentaires spécifiques à l'assemblage .NET.
5. Indiquez le numéro de version. Deux formats de numéro de version sont disponibles :
   • Format standard. Ce format est le format standard géré par Windows. Ce format correspond à un ensemble de 4 nombres séparés par des points.
     • Le premier groupe de 4 chiffres correspond au nombre de changements majeurs effectués dans l'application.
     • Le second groupe de 4 chiffres correspond au nombre de changements mineurs effectués dans l'application.
     • Le troisième groupe de 4 chiffres correspond au numéro de génération.
       Il est conseillé d'incrémenter automatiquement ce numéro à chaque génération. Cette incrémentation est réalisée automatiquement si l'option "Incrémentation automatique de la version à chaque génération" est cochée.
     • Le dernier groupe de 4 chiffres correspond au nombre de révisions (branches dans le GDS par exemple).
       
   • Format pour compatibilité. Ce format était utilisé jusqu'à la version 12 par défaut pour les applications WINDEV.
     Remarque : Tous les caractères (chiffre et lettre) sont autorisés. Par exemple : "1.01A".
     Si l'option "Incrémentation automatique de la version à chaque génération" est cochée, le numéro de version sera modifié à chaque génération : le numéro de version "1.01A" deviendra "1.01B" et le numéro de version "A14Z" deviendra "A15A".
6. Sélectionnez les différents éléments WINDEV (projet, fenêtres, classes, ...) à intégrer dans l'assemblage .NET.
   • Le bouton "Ajouter" permet d'ajouter un élément à l'assemblage .NET : images, fichiers texte, ...
   • Le bouton "Enlever" permet de supprimer un élément de l'assemblage .NET. Les fichiers correspondants et leurs dépendances ne seront pas intégrés dans l'assemblage .NET.
   • Le bouton "WDU" permet d'afficher les éléments présents dans une bibliothèque précédemment créée.
     Remarque : Si le projet WINDEV (fichier ".WDP") est sélectionné :
     • l'analyse du projet sera associée à l'assemblage .NET.
     • l'événement "Initialisation du projet" sera exécuté à l'initialisation de l'assemblage .NET.
     • l'événement "Fermeture du projet" sera exécuté à la fermeture de l'assemblage .NET.
7. Sélectionnez les classes (fichiers ".WDC") et les collections de procédures (fichiers ".WDG") WINDEV à rendre accessibles. Ces classes et ces collections de procédures pourront être manipulées depuis l'application qui utilisera l'assemblage .NET.
   Une classe publique de l'assemblage doit posséder un constructeur sans paramètre (ou avoir tous ses paramètres optionnels).
   Toutes les classes qui sont instanciées dans une classe publique de l'assemblage doivent aussi être publiques.
   Remarque : Une classe .NET est générée avec le nom de la collection de procédures. Cette classe .NET contient :
   • une fonction statique correspondant à chaque fonction de la collection de procédures.
   • un membre statique correspondant à chaque variable de la collection de procédures WINDEV.
8. Sélectionnez :
   
   • la version du Framework .NET ciblé.
   • le Framework WINDEV (32 bits ou 64 bits) à livrer avec l'assemblage .NET.
9. Sélectionnez ensuite les librairies du Framework WINDEV nécessaires au fonctionnement de votre assemblage.
   Remarques :
   • Les librairies du Framework WINDEV correspondant à .NET (par exemple wd300netx.dll) ne peuvent pas être renommées.
   • Si le même projet doit permettre de générer plusieurs versions du même assemblage, il est nécessaire d'utiliser des configurations de projet.
   • Si un assemblage .NET doit fonctionner en 32 bits et en 64 bits, il est nécessaire de générer 2 assemblages .NET en WINDEV. Le même assemblage ne peut pas fonctionner en 32 bits et en 64 bits.
10. Paramétrez si nécessaire le message d'erreur. Ce message sera affiché en cas d'erreur lors de l'utilisation de l'assemblage .NET.
    Le bouton "Défaut" permet de paramétrer un message d'erreur par défaut.
11. Sélectionnez les options spécifiques de l'assemblage :
    • Le bouton "Options de compilation" permet de sélectionner un compilateur C# spécifique et d'indiquer des options de compilations supplémentaires.
    • Le bouton "Propriétés avancées" permet de définir si l'assemblage .NET doit être accessible par un programme utilisant la technologie COM. Pour plus de détails, consultez Créer un assemblage .NET accessible par COM.
12. Validez.

• Les assemblages générés avec WINDEV s'utilisent comme n'importe quel autre assemblage .NET. Cependant, le framework WINDEV doit se trouver dans le même répertoire que l'assemblage.
• Limitation : Les états et les requêtes ne fonctionnent pas dans les assemblages .NET.
• Les assemblages .Net générés avec WINDEV ont un seul contexte d'exécution : ils ne peuvent donc être exécutés que par un seul thread.

Conseils pour optimiser le code des classes

• Typez les paramètres des méthodes et les valeurs de retour.
• Utilisez le mot-clé "LOCAL" afin que les paramètres des méthodes ne soient pas de type "Entrée / Sortie".
• Remplacez les mots réservés du C#.
• Eliminez les héritages multiples.

Types des paramètres et des valeurs de retour

Paramètres en "Entrée / Sortie"

Conséquence : un code d'utilisation de l'assemblage plus simple

1. Créer un "Object".
2. Recopier dans cet "object" la variable type du C#.
3. Passer par référence un "Object" en paramètre à la méthode de la classe WLangage.

1. Parmi les boutons d'accès rapide, sélectionnez le mode de génération "Créer la procédure d'installation de l'assemblage".
   
2. Suivez les instructions des différentes étapes de l'assistant.