写入数据文件

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

选项 

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

兼容性 

产品 是否支持
FileMaker Pro
FileMaker Go
FileMaker WebDirect
FileMaker Server
FileMaker Cloud
FileMaker Data API
自定义 Web 发布

原始版本 

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 ]