Functions.StrToFile 方法 (String, String, Boolean) | |
将字符串的内容写入文件。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION StrToFile(
cExpression AS STRING,
cFileName AS STRING,
lAdditive AS LOGIC
) AS LONG
public static int StrToFile(
string cExpression,
string cFileName,
bool lAdditive
)
查看代码参数
- cExpression
- 类型:String
指定写入文件的字符字符串。cExpression 可以是一个的字符字面量字符串、一个评估为字符串的表达式,或者是一个字符类型的变量、数组元素或字段。
- cFileName
- 类型:String
指定将字符字符串写入的文件名。如果文件不在当前默认目录中,需要包括文件名的路径。 如果指定的文件不存在,X# 会自动创建它。
- lAdditive
- 类型:Boolean
(用于向后兼容)
指定字符字符串是否被追加到文件的末尾。
如果 lAdditive 为真 (.T.),字符字符串将被追加到文件的末尾。
如果 lAdditive 为假 (.F.) (默认),文件将被字符字符串覆盖。
如果 Set SAFETY 设置为 ON,系统会询问是否要覆盖已有的文件。
如果 Set SAFETY 设置为 OFF, 文件将不经提示直接被覆盖。
返回值
类型:
Int32
数值型;写入文件的字节数。
备注
nFlags 值为 3 或 5 是无效的。您不能尝试在 nFlag 位 1,Additive,设置的情况下写入新的字节顺序标记。
与 FoxPro 早期版本不同,StrToFile( ) 打开文件时使用共享模式而不是独占模式。 这对于多个服务器同时尝试写入同一个文件的情况非常有用。由于这个变化, 您可能不需要检查
StrToFile( ) 是否返回 0 (失败打开文件)。
nFlags | 十六进制 | 描述 |
---|
0 (S2F_FLAG_OVERWRITE) (默认) | 0x0000 | 文件被字符字符串覆盖 (以前的 lAdditive=.f.) |
1 (S2F_FLAG_APPEND) | 0x0001 | 字符串被追加到文件的末尾 (以前的 lAdditive=.t.) |
2 (S2F_FLAG_UNICODE_LE) | 0x0002 |
在文件的开始写入小端序 Unicode Byte Order Mark (BOM) FF FE。cExpression 假设为 UNICODE,因此不进行任何翻译。文件被覆盖
|
4 (S2F_FLAG_UTF8) | 0x0004 |
在文件的开始写入 UTF-8 Byte Order Mark (BOM) EF BB BF。cExpression 假设为 UTF-8,因此不进行任何翻译。文件被覆盖。
|
8 (S2F_FLAG_UNICODE_BE) | 0x0008 |
在文件的开始写入大端序 Unicode Byte Order Mark (BOM) FF FE。cExpression 假设为 UNICODE,因此不进行任何翻译。文件被覆盖
|
256 (S2F_FLAG_UNICODE_TEXT) | 0x0100 |
使用正常的 .Net Unicode 文本函数将文件写入磁盘。
|
参见