# WriteData

使用 WriteData 函数将数据写入文件或将数据字符串追加到本地设备或 FTP 服务器上的文件。您可以使用此函数记录数据结果并在文件中查看它们。

注意: 您可以在联机或脱机时将文件保存到选定的存储位置。

## WriteData 输入

参数 | 说明
数据 | 指定文本字符串或对包含要写入或追加到文件的文本字符串的单元格的引用。
事件 | 指定强制更新的事件。 此参数需要是对具有时间戳的任何事件的引用，例如以下之一： 包含事件函数的单元格。 包含按钮函数的单元格。
存储 | 指定是否要将数据文件保存到本地设备或 FTP 服务器。 保存位置取决于连接的设备和函数的存储设置。
存储设置 | 连接的设备 | 保存位置
--- | --- | ---
本地设备 | In-Sight 设备 | In-Sight 设备 安装到 In-Sight 设备的 SD 卡 注意: 您必须使用 FTP 软件（例如 FileZilla Client）才能查看文件。有关详细信息，请参阅如何查看存储在 In-Sight 设备上的文件。 如果您使用 SD 卡存储，请确保在运行作业之前插入 SD 卡。如果您在未插入 SD 卡的情况下配置 SD 卡存储，作业会将文件保存到内部闪存驱动器的 /sdcard 目录。
PC | PC 注意:仅支持使用 FTP 服务器保存到 PC。
FTP 服务器 | 任何设备 | 指定的 FTP 服务器
服务器 | 指定网络上将写入数据文件的 FTP 服务器的服务器名称（或 IP 地址）。FTP 服务器可以是 In-Sight 模拟器或网络上被识别为 FTP 服务器的任何其他设备。 注意: 此选项仅在您选择 FTP 服务器作为存储类型时启用。 如果需要特定端口，您可以将其追加到服务器名称。例如，FTP 服务器使用 50021 端口，输入“127.0.0.1:50021”。
用户名 | 指定 FTP 服务器的用户名。当此字段留空时，将使用“admin”。 注意:此选项仅在您选择 FTP 服务器作为存储类型时启用。
密码 | 指定 FTP 服务器的密码。密码区分大小写。如果 FTP 服务器没有密码，您可以将此字段留空。 注意: 此选项仅在您选择 FTP 服务器作为存储类型时启用。 为了安全起见，输入的密码将在 WriteData 属性表和公式栏中用“*”遮蔽。 密码将以加密形式保存在作业文件中。
文件路径 | 指定要将文件保存到的位置。 在保存到 PC 时，您可以将文件写入您具有操作系统写入权限的任何位置。您可以将硬编码路径（例如 X:/、X:/Subdir）、UNC 路径（例如 //Cognex/shared/）、映射驱动器（例如 M:/Subdir）或相对路径（../../ Subdir) 输入到此字段。 如果路径在 In-Sight 设备或 PC 上不存在，则该函数返回 #ERR。如果 FTP 服务器上的路径或 FTP 凭据无效，则该函数不会返回 #ERR。 如果将该字段留空，则会将文件发送到以下默认位置之一： In-Sight 设备：设备的根目录。 FTP 服务器：指定 FTP 服务器的默认目录。
文件名 | 指定数据文件的名称。 注意:遵守操作系统对合法字符的限制。
数据格式 | 指定文件的类型。扩展名将自动追加到文件名后。
0 = TXT（默认值） | 标准 ASCII 文本文件格式 (.TXT)。
1 = HTML | 标准 HTML 文件格式 (.HTML)。
2 = XML | 标准 XML 文件格式 (.XML)。
3 = CSV | 标准 CSV 文件格式 (.CSV)。
追加 | 指定数据如何写入文件。
0 = OFF | 覆盖文件中的现有数据。
1 = ON （默认值） | 将数据字符串追加到文件末尾。

## WriteData 输出

返回 | WriteData 结构，只要引用的事件被触发，它就会将 Data 参数中包含的数据字符串写入本地设备或 FTP 服务器。 如果任何输入参数无效或文件队列已满，则返回 #ERR。 注意:任何无效的 FTP 服务器、路径或文件名都不会返回 #ERR。