DbFileSpec 类

保存 .DBF 文件的文件名和路径，并提供与 DBF 相关的功能，如创建、复制、删除、移动和重命名文件。

继承层次

Object
FileSpec
DbFileSpec

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

语法

复制

[TypesChangedAttribute]
 CLASS DbFileSpec INHERIT FileSpec

[TypesChangedAttribute]
public class DbFileSpec : FileSpec

查看代码

DbFileSpec 类型公开以下成员。

构造函数

	名称	说明
	DbFileSpec(String, String, __Array)	实例化一个 DBFileSpec 对象，并填充其实例变量与 DBF 信息。
	DbFileSpec(FileSpec, String, __Array)	实例化一个 DBFileSpec 对象，并填充其实例变量与 DBF 信息。

Top

属性

	名称	说明
	Attributes	一个或多个字符连接成一个字符串，表示此文件规范表示的文件的属性： (继承自 FileSpec。)
	DateChanged	表示文件创建或最后更改的日期值。如果未找到文件，则返回 NULL_DATE。 (继承自 FileSpec。)
	DBFAttr	返回的 DBF 文件属性，类型为字符串。
	DBFDateChanged	返回的 DBF 文件日期戳，类型为日期。
	DBFName	DBF 文件的名称和扩展名。
	DBFSize	DBF 文件的大小。
	DBFTime	返回的 DBF 文件时间戳，类型为字符串。
	DbStruct	返回一个包含 DBF 文件结构的数组。
	Delim	访问 CopyTo() 方法使用的分隔符。
	Drive	表示分配给此文件规范的驱动器的字符串。 (继承自 FileSpec。)
	ErrInfo	返回上次 Copy() 或 Move() 操作的错误对象。 (继承自 FileSpec。)
	Extension	表示分配给此文件规范的扩展名的字符串。 (继承自 FileSpec。)
	FCount	DBF 文件中的字段数。
	Fields	使用 CopyTo() 方法时要复制到的 DBF 字段的 1-D 数组。
	FileName	为 DBFileSpec 对象分配一个文件名。 (重写 FileName.)
	ForBlock	用于 CopyTo() 方法的 FOR 条件代码块。
	FullPath	为 DBFileSpec 对象分配一个完整路径，包括驱动器、目录、文件名和扩展名。 (重写 FullPath.)
	HeaderSize	DBF 文件头的大小。
	HidRDDs	用于 CopyTo() 方法的“隐藏” RDDs(例如，DBFMEMO)的1-D数组。
	IndexNames	具有驱动器、路径、文件名和扩展名信息的索引文件的1-D数组。
	IsAnsi	DBF 文件头中使用的 ANSI/OEM 设置。
	LastUpDate	DBF 文件的最后更新日期，如 DBF 头中报告的那样。
	MemAttr	备注文件属性。
	MemBlockSize	备注文件中使用的备注块大小。
	MemDateChanged	作为日期类型返回的备注文件日期戳。
	MemFileExt	不包括文件名的备注文件扩展名。
	MemFileName	不包括文件名扩展名的基本备注文件名。
	MemFullPath	备注文件的完整路径，包括驱动器、目录、文件名和扩展名。
	MemName	备注文件的文件名和扩展名。
	MemSize	备注文件的大小。
	MemTime	作为字符串返回的备注文件时间戳。
	Orders	与此 DBFileSpec 对象关联的 OrderSpec 对象的1-D数组。
	Path	表示分配给此文件规范的路径的字符串。 (继承自 FileSpec。)
	RDD_Name	用于实例化的 RDD 的名称。
	RDD_Version	RDD 的版本号。
	RDDs	用于实例化的“隐藏” RDDs(例如，DBFMEMO)的数组。
	RecCount	DBF 中的记录数。(请注意，“LastRec”在此类中不可用，只在 dbServer 类中可用)
	RecNo	用于 CopyTo() 方法的记录号，当需要单个记录时。
	Records	用于 CopyTo() 方法的记录数。
	RecSize	DBF 的记录大小。
	Rest	逻辑值，确定 CopyTo() 方法是复制所有记录还是当前记录到 EOF。
	RLockCount	DBF 中的锁定记录数。
	SDF	逻辑值，确定 CopyTo() 方法是否将记录复制到 SDF 文件。
	Size	表示由此文件规范表示的文件的大小，以字节为单位。 (继承自 FileSpec。)
	TimeChanged	表示文件创建或最后更改的时间的字符串。 (继承自 FileSpec。)
	WhileBlock	与 CopyTo() 方法一起使用的 WHILE 条件代码块。

Top

方法

	名称	说明
	AppendToPath	将子目录附加到此文件规范路径的末尾。 (继承自 FileSpec。)
	Copy(String, Boolean)	复制此文件规范表示的文件。 (继承自 FileSpec。)
	Copy(FileSpec, Boolean)	复制此文件规范表示的文件。 (继承自 FileSpec。)
	Copy(__Usual, __Usual, __Usual)	将与 DBFileSpec 对象关联的所有文件复制到不同的驱动器和/或目录。
	CopyTo	将 DBFileSpec 对象的 DBF 文件复制到另一种数据格式。这可以用于将文件复制到另一个 RDD，到一个分隔文件，或到一个 SDF 文件。
	Create	使用提供的 DBStruct 数组创建一个给定名称的新 DBF 文件。
	DBFSGetInfo	填充 DBFileSpec 对象的实例变量。当使用 Find() 方法时，如果找到文件，将在内部调用此方法。
	Delete	物理删除与 DBFileSpec 对象关联的所有文件，包括通过 OrderSpec 对象与 DBF 相关的任何索引文件和任何 FPT 文件。 (重写 Delete.)
	Error(Error)	提供一种方法来处理 FileSpec 处理期间引发的错误条件。这是一个事件处理程序：它由其他方法自动调用；开发人员通常不需要调用错误方法，但可能希望替换或修改它。 (继承自 FileSpec。)
	Error(Error, __Symbol)	提供一种方法来处理 FileSpec 处理期间引发的错误条件。这是一个事件处理程序：它由其他方法自动调用；开发人员通常不需要调用错误方法，但可能希望替换或修改它。 (继承自 FileSpec。)
	Find	使用当前目录、SetDefault() 或 SetPath() 方法定位 DBFileSpec 对象中定义的文件。如果成功，将填充 DBFileSpec 的实例变量。 (重写 Find.)
	Move(String, Boolean)	将由此文件规范表示的文件移动到新位置。 (继承自 FileSpec。)
	Move(FileSpec, Boolean)	将由此文件规范表示的文件移动到新位置。 (继承自 FileSpec。)
	Move(__Usual, __Usual, __Usual)	将与 DBFileSpec 对象关联的所有文件移动和/或重命名到不同的驱动器和/或目录。更新 DBFileSpec 和/或 OrderSpec 实例变量。还将重命名自动打开的索引文件。只有 DBF、MEMO 和自动打开的索引文件会被重命名。
	PathUp	从此文件规范的路径的末尾删除最后一个子目录。 (继承自 FileSpec。)
	Rename(String, Boolean)	重命名由此文件规范表示的文件。 (继承自 FileSpec。)
	Rename(__Usual, __Usual)	重命名与 DBFileSpec 对象关联的文件。只有 DBF/MEMO 和自动打开的索引文件会被重命名。如果文件已经打开或在移动过程中存在文件名冲突，Rename() 不会重命名文件。要将文件重命名到另一个目录，使用 Move() 方法并提供不同的目标文件名。
	Rename(FileSpec, Boolean)	重命名由此文件规范表示的文件。 (继承自 FileSpec。)

Top

备注

FileSpec 是一个通用的对象，它保存文件的文件名和路径。DBFileSpec 子类专门用于保存 .DBF 文件的信息。 FileSpec 类不包含任何用于读取或写入文件的方法，但实际上你可以使用这个类创建一个 DBF 结构；它仅限于目录级别的属性，如大小、日期和时间更改以及操作，如删除和重命名。 DBFileSpec 添加了两个仅适用于 DBF 文件的操作：通过 DBFileSpec:DBStruct 读取记录布局和通过 DBFileSpec:Create() 创建文件。请注意，DBServer 对象在实例化时打开一个现有文件；它要求文件存在，因此不能用于创建 DBF 文件。 DBFileSpec:Create() 是创建 DBF 文件的理想方法。 DBStruct 可以作为 DBServer 类的访问方法，但实例化 DBServer 是读取文件头的一个不必要的复杂方式。 DBFileSpec:DBStruct 是获取记录布局的一种更简单的方式。

示例

这两种方法可以一起使用，与 FileSpec 类的路径操作方法一起。例如，要在不同驱动器上的相应目录中创建一个新文件，该文件的记录布局与现有文件相同，你可能会这样做：

复制

1oDBFileSpec := DBFileSpec{"c:\data\custdata.dbf"}
2
3IF oDBFileSpec:Find() // 文件存在吗？
4  aDBStruct         := oDBFileSpec:DBStruct
5  oDBFileSpec:Drive := "d:"
6  oDBFileSpec:Create(aDBStruct)
7ENDIF

参见

引用

XSharp.VO.SDK 命名空间