FileSpec 类

创建一个文件规范，它提供了一个有用的框架来管理文件名和路径。

继承层次

Object
FileSpec
DbFileSpec

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

语法

复制

[TypesChangedAttribute]
 CLASS FileSpec

[TypesChangedAttribute]
public class FileSpec

查看代码

FileSpec 类型公开以下成员。

构造函数

	名称	说明
	FileSpec	构造一个文件规范。

Top

属性

	名称	说明
	Attributes	一个或多个字符连接成一个字符串，表示此文件规范表示的文件的属性：
	DateChanged	表示文件创建或最后更改的日期值。如果未找到文件，则返回 NULL_DATE。
	Drive	表示分配给此文件规范的驱动器的字符串。
	ErrInfo	返回上次 Copy() 或 Move() 操作的错误对象。
	Extension	表示分配给此文件规范的扩展名的字符串。
	FileName	表示分配给此文件规范的文件名的字符串。
	FullPath	表示分配给此文件规范的完整路径名的字符串。
	Path	表示分配给此文件规范的路径的字符串。
	Size	表示由此文件规范表示的文件的大小，以字节为单位。
	TimeChanged	表示文件创建或最后更改的时间的字符串。

Top

方法

	名称	说明
	AppendToPath	将子目录附加到此文件规范路径的末尾。
	Copy(String, Boolean)	复制此文件规范表示的文件。
	Copy(FileSpec, Boolean)	复制此文件规范表示的文件。
	Delete	删除此文件规范表示的文件。
	Error(Error)	提供一种方法来处理 FileSpec 处理期间引发的错误条件。这是一个事件处理程序：它由其他方法自动调用；开发人员通常不需要调用错误方法，但可能希望替换或修改它。
	Error(Error, __Symbol)	提供一种方法来处理 FileSpec 处理期间引发的错误条件。这是一个事件处理程序：它由其他方法自动调用；开发人员通常不需要调用错误方法，但可能希望替换或修改它。
	Find	在磁盘上搜索由此文件规范表示的文件，指示它是否存在，如果存在，将其完整路径信息存储在此文件规范中以供将来参考。
	Move(String, Boolean)	将由此文件规范表示的文件移动到新位置。
	Move(FileSpec, Boolean)	将由此文件规范表示的文件移动到新位置。
	PathUp	从此文件规范的路径的末尾删除最后一个子目录。
	Rename(String, Boolean)	重命名由此文件规范表示的文件。
	Rename(FileSpec, Boolean)	重命名由此文件规范表示的文件。

Top

备注

文件规范旨在作为一种存储和管理文件名和路径相关信息的方法。它提供了一些用于复制、移动、删除和重命名文件的方法，以及用于检索文件信息的访问方法。如果未使用 FileSpec 类提供的分配方法指定路径，则通过 SetDefault() 和 SetPath() 函数获取路径。该类允许您以通用方式管理所有不同类型文件的数据。因此，它不提供处理文件的方法，例如读取和写入文件，因为这些方法取决于文件的类型。例如，.DBF 文件可以使用 DBServer 对象处理；其他文件可以使用函数或定制的 FileSpec 子类处理，这些子类已定制用于处理不同类型的文件。

示例

文件规范通常用作 DBServer 对象和方法的参数。例如，要将选定的记录从一个文件复制到另一个文件：

复制

 1// 源文件
 2oFSSource := FileSpec{"c:\data\customer"}
 3// 对于目标文件，使用源文件的路径
 4oFSTarget := FileSpec{oFSSource:FullPath}
 5// 更改目标文件的文件名
 6oFSTarget:FileName := "nycust"
 7// 在服务对象中打开源文件
 8oDBSource := DBServer{oFSSource}
 9// 将记录复制到目标文件
10oDBSource:CopyDB(oFSTarget,,{||STATE="NY"})

FileSpec 对象也是查找当前目录然后根据逻辑结构在子目录中搜索的便捷方法：

复制

1oFileSpec := FileSpec{}
2oFileSpec:Path := CurDir()
3oFileSpec:AppendToPath("data")
4oFileSpec:FileName := "custdata"
5oDB := DBServer{oFileSpec}

参见

引用

XSharp.VO.SDK 命名空间