Functions.FCreate 方法 (String, UInt32)

创建文件或打开并截断现有文件。

命名空间： XSharp.Core
程序集： XSharp.Core (在 XSharp.Core.dll 中) 版本：2.22 GA

语法

 FUNCTION FCreate(
	cFileName AS STRING,
	kAttributes AS DWORD
) AS IntPtr

public static IntPtr FCreate(
	string cFileName,
	uint kAttributes
)

查看代码

参数

cFileName: 类型：String
要创建的文件名，包括可选的驱动器、目录和扩展名。忽略 SetDefault() 和 SetPath() 设置；除非您在文件名中指定驱动器和目录，否则使用 Windows 默认设置。不假定任何扩展名。
如果文件已存在，其长度将被截断为 0，且不会发出警告。
在并发控制冲突的情况下，此函数会设置 NetErr()。
kAttributes: 类型：UInt32
以下常量之一，指示创建文件时要设置的属性：
常量描述
FC_ARCHIVED 已归档文件
FC_HIDDEN 隐藏文件
FC_NORMAL 普通读/写文件
FC_READONLY 只读文件
FC_SYSTEM 系统文件

返回值

类型：IntPtr
新文件的 DOS 文件句柄号。
如果发生错误，FCreate() 返回 F_ERROR。可以使用 FError() 确定具体错误。

备注

FCreate() 是一个低级文件函数，可以创建新文件或打开现有文件并将其截断为 0 长度。
如果 cFileName 不存在，则创建并打开它以进行写入。
如果文件存在且可以打开进行写入，则将其截断为 0 长度。当 FCreate() 成功创建新文件时，文件以兼容共享模式和读/写访问模式保持打开状态。
nAttribute 指定的文件属性在文件关闭时应用于新文件，允许您写入新创建的只读文件。
有关访问模式的列表，请参见 FOpen()。由于其他文件函数需要文件句柄来识别打开的文件，因此始终将 FCreate() 的返回值分配给变量以供后续使用。

示例

此示例创建一个名为 TESTFILE 的文件并打开它以进行读写：

复制

1IF (ptrHandle := FCreate("testfile")) = F_ERROR
2    ? DOSErrString(FError())
3ELSE
4    FWrite(ptrHandle, "你好")
5    FClose(ptrHandle)
6ENDIF

参见

引用

FCreate2(String, UInt32)

FError

FOpen