Skip to main content

Nomi e regole di denominazione

Questo capitolo tratta la codifica dei nomi degli oggetti e dei nomi delle cartelle, nonché le regole di denominazione applicabili e le cartelle riservate per CODESYS File-Based Storage.

Codifica dei nomi

I nomi degli oggetti e delle cartelle a volte contengono caratteri non consentiti nei percorsi del file system o che hanno un significato speciale. Questi caratteri vengono codificati da CODESYS File-Based Storage in modo che il progetto rimanga portabile tra Windows e Linux.

I seguenti caratteri sono codificati:

  • Characters which Windows does not allow in a path: < > : " / \ | ? *

  • Caret (^ ) perché identifica le directory dei contenitori

  • Tutti i caratteri di controllo

  • Periodo (. ) perché separa il nome dalla parte della classe e dalla parte della lingua

Ogni carattere codificato è scritto come due underscore seguiti dal codice esadecimale a due cifre del carattere. Quindi il punto diventa __2e, la barra diventa __2f e il cursore diventa __5e.

Se il nome di un oggetto corrisponde a un nome di dispositivo Windows riservato, il nome è racchiuso tra trattini bassi. I nomi di dispositivo Windows riservati sono CON, PRN, AUX, NUL, COM1 A COM9, E LPT1 A LPT9. CON diventerà _CON_.

Regole di denominazione

Per garantire che i progetti rimangano portatili e adatti ai sistemi di controllo della versione, CODESYS File-Based Storage Verranno controllati i nomi degli oggetti. Le violazioni verranno segnalate.

  • Il nome dell'oggetto, inclusi il suffisso di classe e il suffisso di lingua, non deve superare i 240 caratteri. Anche il nome di una cartella non deve superare i 240 caratteri.

  • I nomi degli oggetti non devono contenere il simbolo del cancelletto (#).

  • I nomi degli oggetti non devono iniziare né terminare con uno spazio.

  • Non è possibile che due cartelle abbiano lo stesso nome, nemmeno in parti diverse del progetto. Il confronto non tiene conto della distinzione tra maiuscole e minuscole.

  • Un oggetto di programmazione non deve contenere due metodi con lo stesso nome.

  • Un progetto non deve fare riferimento a due librerie che utilizzano lo stesso namespace.

Se CODESYS rileva una violazione durante una conversione, quindi il problema verrà segnalato. Se possibile, verrà fornita una soluzione rapida. Conversione del progetto in corso Il comando descrive le soluzioni rapide disponibili.

Cartelle riservate

Diverse cartelle vengono utilizzate da CODESYS File-Based Storage per scopi interni, tra cui .FBS_Project_Related, .auxiliaries, E .sidecars Non creare cartelle di progetto con questi nomi.

IL .auxiliaries E .sidecars Le cartelle includono contenuti locali o generati. Escludere sempre queste cartelle dai sistemi di controllo della versione.