Functions.StrToFile 方法 (String, String, Int32) | |
将字符串的内容写入文件。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION StrToFile(
cExpression AS STRING,
cFileName AS STRING,
nFlags AS LONG
) AS LONG
public static int StrToFile(
string cExpression,
string cFileName,
int nFlags
)
查看代码参数
- cExpression
- 类型:String
指定写入文件的字符字符串。cExpression 可以是一个的字符字面量字符串、一个评估为字符串的表达式,或者是一个字符类型的变量、数组元素或字段。
- cFileName
- 类型:String
指定将字符字符串写入的文件名。如果文件不在当前默认目录中,需要包括文件名的路径。 如果指定的文件不存在,X# 会自动创建它。
- nFlags
- 类型:Int32
您可以使用 nFlag 参数代替 lAdditive,这样您也可以选择写入 UTF-8 和 Unicode 字节顺序标记。
备注部分描述了有效的 nFlag 值。
返回值
类型:
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 文本函数将文件写入磁盘。
|
参见