Namen und Namensregeln
In diesem Kapitel werden die Kodierung von Objekt- und Ordnernamen sowie die geltenden Namensregeln und die für CODESYS File-Based Storage reservierten Ordner beschrieben.
Kodierung der Namen
Objekt- und Ordnernamen enthalten mitunter Zeichen, die in Dateisystempfaden nicht zulässig sind oder eine besondere Bedeutung haben. Diese Zeichen werden von CODESYS File-Based Storage kodiert, damit das Projekt zwischen Windows und Linux portabel bleibt.
Die folgenden Zeichen werden kodiert:
Die Zeichen, die Windows in einem Pfad nicht zulässt:
< > : " / \ | ? *Das Zirkumflex
^, da er Container-Verzeichnisse kennzeichnetAlle Steuerzeichen
Der Punkt
., da er den Namen vom Klassen- und Sprachteil trennt
Jedes kodierte Zeichen wird als zwei Unterstriche gefolgt vom zweistelligen Hexadezimalcode des Zeichens geschrieben. Der Punkt wird so zu __2e, der Schrägstrich zu __2f und der Zirkumflex zu __5e.
Wenn ein Objektname einem reservierten Windows-Gerätenamen entspricht, wird der Name in Unterstriche eingeschlossen. Reservierte Windows-Gerätenamen sind CON, PRN, AUX, NUL, COM1 bis COM9 und LPT1 bis LPT9. Aus CON wird so _CON_.
Namensregeln
Damit Projekte portabel und für die Versionsverwaltung geeignet bleiben, werden Objektnamen von CODESYS File-Based Storage geprüft. Verstöße werden gemeldet.
Der Objektname darf einschließlich Klassen- und Sprachsuffix 240 Zeichen nicht überschreiten. Ein Ordnername darf ebenfalls 240 Zeichen nicht überschreiten.
Objektnamen dürfen kein Rautezeichen
#enthaltenObjektnamen dürfen nicht mit einem Leerzeichen beginnen oder enden
Zwei Ordner dürfen nicht denselben Namen tragen, auch nicht in unterschiedlichen Teilen des Projekts. Der Vergleich berücksichtigt die Groß- und Kleinschreibung nicht.
Ein Programmierobjekt darf nicht zwei Methoden mit demselben Namen enthalten
Ein Projekt darf nicht zwei Bibliotheken über denselben Namespace referenzieren
Wenn CODESYS während einer Konvertierung einen Verstoß findet, wird das Problem gemeldet. Wenn möglich, wird eine Schnellbehebung angeboten. Die verfügbaren Schnellbehebungen beschreibt der Befehl Projekt konvertieren.
Reservierte Ordner
Mehrere Ordner werden von CODESYS File-Based Storage für eigene Zwecke verwendet, darunter .FBS_Project_Related, .auxiliaries und .sidecars. Legen Sie keine Projektordner mit diesen Namen an.
Die Ordner .auxiliaries und .sidecars enthalten lokale oder generierte Inhalte. Schließen Sie diese Ordner grundsätzlich von der Versionsverwaltung aus.