写入数据文件

将数据写入打开的数据文件。

选项 

• “文件 ID”是一个数字表达式，指定了打开的数据文件的文件 ID。请参阅打开数据文件脚本步骤。
• “数据源”是包含要写入文件的数据的字段或变量。
• “写入为”使用 FileMaker Pro 中的默认 UTF-16 (小字节序) 字符编码或 UTF-8 将数据写入文件。如果数据源为容器数据，则会忽略此选项，并将数据写入为二进制。
• “附加换行符”在写入到文件的数据末尾添加换行符。

原始版本 

18.0

说明 

文件中读写位置的数据被来自“数据源”的数据改写。请参阅设置数据文件位置脚本步骤。

此脚本步骤一次可写入的最大数据量为 64 MB。如果写入的数据超过 64 MB，则可以多次执行此脚本步骤，每次写入的数据量不超过 64 MB。

注释 

• 写入不超过 64 KB 时，性能最佳。

示例 1 

将变量的内容后跟换行符，作为 UTF-8 编码的文本写入文件 ID 为 2 的打开的数据文件。

写入数据文件 [文件 ID:2 ; 数据源: $变量 ; 写入为:UTF-8 ; 附加换行符 ]

示例 2 

检查 Documents 文件夹中名为 change.log 的文件是否存在，如果不存在，则要创建文件，将数据从“活动::交易”字段写入文件开头，然后关闭文件。

设置变量 [$文件; 值:Get (文档路径) & "change.log" ]
获取文件存在的值 [ "$文件" ; 目标: $文件已存在 ]
If [ $文件不存在 ]
    创建数据文件 ["$文件" ; 创建文件夹:关闭 ]
End If
打开数据文件 ["$文件" ; 目标: $文件 ID ]
写入数据文件 [文件 ID: $文件 ID ; 数据源:活动::交易 ; 写入为:UTF-8 ; 附加换行符 ]
关闭数据文件 [文件 ID: $文件 ID ]

示例 3 

将数据从字段写入名为 dates.txt 的文件中的特定位置。脚本运行前，文件包含“2024-11-30”，“表::月”字段包含“12”。脚本运行后，文件包含“2024-12-30”。

打开数据文件 ["dates.txt" ; 目标: $文件 ID ]
设置数据文件位置 [文件 ID: $文件 ID ; 新位置:5 ]
写入数据文件 [文件 ID: $文件 ID ; 数据源:表::月份 ; 写入为:UTF-8 ]
关闭数据文件 [文件 ID: $文件 ID ]

相关主题 

• 读取数据文件脚本步骤
• 脚本步骤参考