Skip to main content

Noms et règles de dénomination

Ce chapitre traite de l'encodage des noms d'objets et des noms de dossiers, ainsi que des règles de nommage applicables et des dossiers réservés à cet effet. CODESYS File-Based Storage.

Encodage des noms

Les noms d'objets et de dossiers contiennent parfois des caractères non autorisés dans les chemins d'accès au système de fichiers ou ayant une signification particulière. Ces caractères sont encodés par CODESYS File-Based Storage afin que le projet reste portable entre Windows et Linux.

Les caractères suivants sont encodés :

  • Caractères que Windows n'autorise pas dans un chemin : < > : " / \ | ? *

  • Caret (^ ) car il identifie les répertoires de conteneurs

  • Tous les caractères de contrôle

  • Période (. ) parce qu'il sépare le nom de la partie classe et de la partie langue

Chaque caractère codé est écrit sous la forme de deux traits de soulignement suivis du code hexadécimal à deux chiffres du caractère. Le point devient donc __2e, la barre oblique devient __2f, et le caret devient __5e.

Si un nom d'objet correspond à un nom de périphérique Windows réservé, il est encadré par des traits de soulignement. Les noms de périphériques Windows réservés sont : CON, PRN, AUX, NUL, COM1 à COM9, et LPT1 à LPT9. CON deviendra _CON_.

Règles de dénomination

Afin de garantir que les projets restent portables et compatibles avec les systèmes de contrôle de version, CODESYS File-Based Storage Nous vérifierons les noms des objets. Les infractions seront signalées.

  • Le nom de l'objet, y compris le suffixe de classe et le suffixe de langue, ne doit pas dépasser 240 caractères. Le nom d'un dossier ne doit pas non plus dépasser 240 caractères.

  • Les noms d'objets ne doivent pas contenir de symbole dièse (#).

  • Les noms d'objets ne doivent pas commencer ni se terminer par un espace.

  • Deux dossiers ne peuvent pas porter le même nom, même s'ils se trouvent dans des parties différentes du projet. La comparaison ne tient pas compte de la casse.

  • Un objet de programmation ne doit pas contenir deux méthodes portant le même nom.

  • Un projet ne doit pas référencer deux bibliothèques utilisant le même espace de noms.

Si CODESYS Si une violation est détectée lors d'une conversion, le problème sera signalé. Si possible, une solution rapide sera proposée. Conversion du projet Cette commande décrit les solutions rapides disponibles.

Dossiers réservés

Plusieurs dossiers sont utilisés par CODESYS File-Based Storage à des fins internes, y compris .FBS_Project_Related, .auxiliaries, et .sidecars Ne créez pas de dossiers de projet portant ces noms.

Le .auxiliaries et .sidecars Les dossiers contiennent du contenu local ou généré. Il faut toujours exclure ces dossiers des systèmes de contrôle de version.

Dans cette section​: