Windows配置文件由分节命名的文本文件组成。分节的名称位于方括号中。文件中的每个分节名称必须唯一。分节包括由等号(=)隔开的一对键/值。在每个分节中,键名必须唯一。键名代表配置选项,值名代表该选项的设置。以下例子显示了文件的结构:

[Section 1]

key1=value

key2=value

[Section 2]

key1=value

key2=value

在配置文件VI中参数的值部分可用以下数据类型:

  • 字符串
  • 路径
  • 布尔
  • 64位二进制双精度浮点数
  • 32位有符号整数
  • 32位无符号整数
注: LabVIEW写入的布尔值为TRUEFALSE。布尔值不区分大小写。例如,Falsefalse0都是可以接受的FALSE布尔值。

如要使用配置文件VI,必须正确格式化.ini文件中的各行文本。每一行或者为空,或者为段名、键值或注释。

注:“配置文件”VI仅可用于ANSI格式的Windows配置设置文件。

按照下列规范格式化段名行:

  • 键名至少为一个字符
  • 名称中不要使用右括号
  • 不要使用不可打印字符
  • 使用左括号作为第一个非空白字符
  • 在文本行结束位置使用右括号
  • 所有字符在一行内

按照下列规范格式化键值行:

  • 段名行之下各行应包括两部分信息
  • 键名后应跟一个等号
  • 所有字符在一行内
  • 使用合法的键名
    • 键名至少为一个字符
    • 键名不要以分号为首字符
    • 键名中不要出现等号
    • 键名不要以左括号为首字符
    • 不要以空白字符开始
    • 不要以空白字符结束
    • 不要使用不可打印字符
  • 使用合法的值
    • 保持数据类型的一致性
    • 不要以空白字符开始
    • 不要以空白字符结束
注:如值以空白符开始和结束,则必须将值放在引号内。VI返回值时,LabVIEW将移除引号。

配置文件VI在读取操作时将忽略没有段名或值的文本行,在写入操作的时候将会预留没有段名或值的行。

当VI写入配置文件时,任何字符串或路径数据两边都有引号。LabVIEW也支持在.ini文件中使用单引号。

配置文件的注释部分以分号开始,分号之后的文本为注释的内容。分号在行首表示注释。段名、数值或布尔值中的分号也表示注释内容。但是,字符串中的分号不表示注释内容。

如分号是键名的首字符,LabVIEW不会返回键名或键值,因为配置文件不支持分号作为键名首字符。如键名中分号是除首字符之外的任何字符,LabVIEW可返回包含分号的键名。

下表解释了配置文件VI如何读取.ini文件中的段名。

.ini文件的文本范例 段名
[sec1] sec1
[[sec2]] [sec2
[sec with spaces] sec with spaces
[seccom] ;comments seccom
[sectext] sometext sectext

下表解释了配置文件VI如何读取.ini文件中的键值。

.ini文件的文本范例 键名
keyname='mystring' keyname mystring
;keyname="mystring"
keyname="my;string" keyname my;string
keyname = 12.3 ;comm keyname 12.3
key;name="mystring" key;name mystring
key\;name="my;string";more key\;name "my;string";more
key name6=" mystring6" key name6 mystring6
keyname8 = mystring8 keyname8 mystring8
keyname9 = " mystring9 " keyname9 mystring9
keyname12==mystring12 keyname12 =mystring12
#keyname13 = mystring13 #keyname13 mystring13
abc= abc
abc
注:因为读取键VI是一个多态VI,具体实例的工作方式有所区别。例如,对于keyname = 12.3 ;comm键值对,VI的字符串实例将返回字符串12.3;comm,双精度实例将返回数值12.3

“配置文件”VI可读写原始或经转换的字符串数据。该VI可逐字节读写原始数据,而不需要将数据转换成ASCII代码。在已转换的字符串中,LabVIEW在配置文件中用对等的十六进制转换码保存任何不可显示的文本字符,如\0D表示回车。此外,LabVIEW在配置文件中将反斜杠符号存储为双反斜杠符号,即用\\表示\。将配置文件VI的读取原始字符串?写入原始字符串?的输入设置为TRUE,则输入原始数据,FALSE则使用转换后的数据。

配置设置文件中,LabVIEW将路径数据存储在标准Linux路径格式中。根据不同的平台,VI将存储在配置文件中的绝对路径/c/temp/data.dat解析为如下路径:

  • (Windows) c:\temp\data.dat
  • (macOS 32位)c:temp:data.dat
  • (macOS 64位和Linux)/c/temp/data.dat

根据平台的不同,VI将相对路径temp/data.dat解析为如下路径:

  • (Windows) temp\data.dat
  • (macOS 32位):temp:data.dat
  • (macOS 64位和Linux)temp/data.dat