名称和命名规则
本章涵盖对象名称和文件夹名称的编码,以及适用的命名规则和预留文件夹。CODESYS File-Based Storage。
名称编码
对象名称和文件夹名称有时包含文件系统路径中不允许使用的字符或具有特殊含义的字符。这些字符会进行编码。CODESYS File-Based Storage这样,该项目就可以在 Windows 和 Linux 之间移植。
以下字符已编码:
Windows 不允许在路径中出现的字符:
< > : " / \ | ? *插入符号(
^因为它能识别容器目录所有控制字符
时期 (
.因为它将名称与类部分和语言部分分开。
每个编码字符都写成两个下划线,后跟该字符的两位十六进制代码。因此,小数点就变成了__2e斜杠变成了__2f,插入符号变为__5e。
如果对象名称与保留的 Windows 设备名称匹配,则该名称用下划线括起来。保留的 Windows 设备名称是CON,PRN,AUX,NUL,COM1到COM9, 和LPT1到LPT9。CON将成为_CON_。
命名规则
为了确保项目保持可移植性并适用于版本控制系统,CODESYS File-Based Storage将检查对象名称。违规行为将被报告。
对象名称(包括类后缀和语言后缀)不得超过 240 个字符。文件夹名称也不得超过 240 个字符。
对象名称不得包含井号 (#)
#)。对象名称不能以空格字符开头或结尾。
即使在项目的不同部分,两个文件夹也不能同名。比较时不会区分大小写。
一个编程对象不能包含两个同名的方法。
一个项目不能引用两个使用相同命名空间的库。
如果CODESYS如果在转换过程中检测到违规行为,则会报告该问题。如果可能,将提供快速修复方案。转换工程该命令描述了可用的快速修复方法。
预留文件夹
使用了多个文件夹CODESYS File-Based Storage用于内部目的,包括.FBS_Project_Related,.auxiliaries, 和.sidecars请勿创建以此命名的项目文件夹。
这.auxiliaries和.sidecars文件夹包含本地内容或系统生成的内容。务必将这些文件夹从版本控制系统中排除。