解读VC++程序开发中的文件操作API和CFile类
在VC编程中，操作文件的方法主要有两种：利用API函数和MFC的CFile类。微软在其中封装了文件的一般操作，下面我就介绍一下如何利用这两种方法实现文件操作。1．创建或打开一个文件
API函数CreateFile可打开和创建文件、管道、邮槽、通信服务、设备以及控制台，但是在此时只是介绍用这个函数怎么实现创建和打开一个文件。
| HANDLE CreateFile( LPCTSTR lpFileName, // 要打开的文件名 DWORD dwDesiredAccess, // 文件的操作属性 DWORD dwShareMode, // 文件共享属性 LPSECURITY_ATTRIBUTES lpSecurityAttributes,// 文件安全特性 DWORD dwCreationDisposition, //文件操作 DWORD dwFlagsAndAttributes, // 文件属性 HANDLE hTemplateFile // 如果不为零，则指定一个文件句柄。新文件将从这个文件中复制扩展属性 ); |
文件的操作属性：如果为零，表示只允许获取与一个设备有关的信息，GENERIC_READ 表示允许对设备进行读访问；如果为 GENERIC_WRITE 表示允许对设备进行写访问（可组合使用）；
文件的共享属性：零表示不共享； FILE_SHARE_READ 或 FILE_SHARE_WRITE 表示允许对文件进行读/写共享访问；
文件的操作有：
·CREATE_NEW：创建文件；如文件存在则会出错
·CREATE_ALWAYS：创建文件，会改写前一个文件
·OPEN_EXISTING：文件必须已经存在。
|
|
|
·OPEN_ALWAYS：如文件不存在则创建它
·TRUNCATE_EXISTING：将现有文件缩短为零长度
文件属性有：
·FILE_ATTRIBUTE_ARCHIVE：标记归档属性
·FILE_ATTRIBUTE_COMPRESSED：将文件标记为已压缩，或者标记为文件在目录中的默认压缩方式
·FILE_ATTRIBUTE_NORMAL：默认属性
·FILE_ATTRIBUTE_HIDDEN：隐藏文件或目录
·FILE_ATTRIBUTE_READONLY：文件为只读
·FILE_ATTRIBUTE_SYSTEM：文件为系统文件
·FILE_FLAG_WRITE_THROUGH：操作系统不得推迟对文件的写操作
·FILE_FLAG_OVERLAPPED：允许对文件进行重叠操作
·FILE_FLAG_NO_BUFFERING：禁止对文件进行缓冲处理。文件只能写入磁盘卷的扇区块
·FILE_FLAG_RANDOM_ACCESS：针对随机访问对文件缓冲进行优化
·FILE_FLAG_SEQUENTIAL_SCAN：针对连续访问对文件缓冲进行优化
·FILE_FLAG_DELETE_ON_CLOSE：关闭了上一次打开的句柄后，将文件删除。特别适合临时文件
可以组合的属性有：FILE_FLAG_WRITE_THROUGH，FILE_FLAG_OVERLAPPED，FILE_FLAG_NO_BUFFERING，FILE_FLAG_RANDOM_ACCESS，FILE_FLAG_SEQUENTIAL_SCAN，FILE_FLAG_DELETE_ON_CLOSE，FILE_FLAG_BACKUP_SEMANTICS，FILE_FLAG_POSIX_SEMANTICS，FILE_FLAG_OPEN_REPARSE_POINT，FILE_FLAG_OPEN_NO_RECALL
如果成功返回一个打开文件得句柄，如果调用函数之前文件存在，文件操作属性为：CREATE_ALWAYS 或 OPEN_ALWAYS，使用GetLastError函数返回的是ERROR_ALREADY_EXISTS（包括函数操作成功），如果之前函数不存在，则返回0。使用失败返回INVALID_HANDLE_VALUE，要取得更多的信息，使用GetLastError函数。
文件关闭用：
| BOOL CloseHandle(HANDLE hObject // handle to object to close); |
例子1、在当前目录下面创建一个文件：
| HANDLE handle; DWORD Num; handle= ::CreateFile("new.tmp",GENERIC_READ|GENERIC_WRITE,0,NULL,OPEN_ALWAYS,FILE_FLAG_DELETE_ON_CLOSE,NULL); if(INVALID_HANDLE_VALUE!= handle ) { ::SetFilePointer(handle,0,0,FILE_BEGIN); char Buffer[] = "这是个刚创建的文件"; ::WriteFile(handle,Buffer,sizeof(Buffer),&Num,NULL); ZeroMemory(Buffer,sizeof(Buffer)); ::SetFilePointer(handle,0,0,FILE_BEGIN); ::ReadFile(handle,Buffer,sizeof(Buffer),&Num,NULL); MessageBox(Buffer); ::CloseHandle(handle); } |
可以改变上面的创建文件的属性和操作看下不同效果。
CFile创建和打开一个文件：
创建文件和打开文件的方法有很多种，下面简单介绍下几个构造函数：
| CFile( LPCTSTR lpszFileName, UINT nOpenFlags ); throw( CFileException ); CFile( ); BOOL Open( LPCTSTR lpszFileName, UINT nOpenFlags, CFileException* pError = NULL ); |
lpszFileName:文件名称，可以是相对路径，绝对路径或网络路径
nOpenFlags：打开方式有：
·CFile::modeCreate 调用构造函数构造一个新文件，如果文件已存在，则长度变成0。
·CFile::modeNoTruncate 此值与modeCreate组合使用。如果所创建的文件已存在则其长度不变为0。因而此文件被打开，或者作为一个新文件或者作为一个已存在的文件。这将是很有用的，例如当打开一个可能存在也可能不存在的文件时。
·CFile::modeRead 打开文件仅供读。
·CFile::modeReadWrite 打开文件供读写。
·CFile::modeWrite 打开文件仅供写。
·CFile::modeNoInherit 阻止文件被子进程继承。
·CFile::ShareDenyNone 不禁止其它进程读或写访问，打开文件。如果文件已被其它进程以兼容模式打开，则Create失败。
·CFile::ShareDenyRead 打开文件，禁止其它进程读此文件。如果文件已被其它进程以兼容模式打开，或被其它进程读，则Create失败。
·CFile::ShareDenyWrite 打开文件，禁止其它进程写此文件。如果文件已被其它进程以兼容模式打开，或被其它进程写，则Create失败。
·CFile::ShareExclusive 以独占模式打开文件，禁止其它进程对文件的读写。如果文件已经以其它模式打开读写（即使被当前进程），则构造失败。
·CFile::ShareCompat 此标志在32位MFC中无效。此标志在使用CFile:: Open时映射为CFile::ShareExclusive。
·CFile::typeText 对回车换行设置特殊进程（仅用于派生类）。
·CFile::typeBinary 设置二进制模式（仅用于派生类）。
下面给出MSDN中的一个例子：
| char* pFileName = "test.dat"; TRY { CFile f( pFileName, CFile::modeCreate | CFile::modeWrite ); } CATCH( CFileException, e ) { #ifdef _DEBUG afxDump << "File could not be opened " << e->m_cause << "\n"; #endif } END_CATCH CFile fileTest; char* pFileName = "test.dat"; TRY { fileTest.Open(pFileName, CFile::modeCreate |CFile::modeWrite); } CATCH_ALL(e) { fileTest.Abort( ); THROW_LAST ( ); } END_CATCH_ALL |
定位文件中的数据是很重要的，这决定了写入的数据在文件中的位置。API函数
| DWORD SetFilePointer( HANDLE hFile, //文件的句柄 LONG lDistanceToMove, //字节偏移量r PLONG lpDistanceToMoveHigh, //指定一个长整数变量，其中包含了要使用的一个高双字偏移（一般用来操作大型文件）。可设为零，表示只使用lDistanceToMove DWORD dwMoveMethod //文件定位 ); |
dwMoveMethod文件定位的方式有三种：
·FILE_BEGIN：从文件开始处。
·FILE_CURRENT：从当前位置。
·FILE_END：从文件的末尾。
此函数可以用来定位大型文件，lpDistanceToMoveHigh是高32位，lDistanceToMove是低32位。如果lpDistanceToMoveHigh为NULL时，函数操作成功，返回的是当前文件数据的偏移量，如果lpDistanceToMoveHigh不NULL，则返回数据的偏移量高32位放在 lpDistanceToMoveHigh中，函数调用失败返回的是0xffffffff.
| BOOL SetEndOfFile(HANDLE hFile //文件的句柄); |
CFile类的文件数据定位函数有：
| LONG Seek(LONG lOff,UINT nFrom); throw(CFileException); |
如果要求的位置合法，则Seek返回从文件开始起的新字节偏移量
lOff：指针移动的字节数。
nFrom：指针移动的模式。可以是CFile::begin，CFile::current，CFile::end
void SeekToBegin( );
DWORD SeekToEnd( );//返回文件长度（字节数）。
下面是一个读取位图文件的信息的例子：
| CFile file; BITMAPINFOHEADER bmpinfo; try { file.Open("D:\\ToolBar.bmp",CFile::modeRead); file.Seek(sizeof(BITMAPFILEHEADER),CFile::begin); file.Read(&bmpinfo,sizeof(BITMAPINFOHEADER )); CString str; str.Format("位图文件的长是%d,高%d",bmpinfo.biWidth,bmpinfo.biHeight); MessageBox(str); file.Close(); } catch(CFileException *e) { CString str; str.Format("读取数据失败的原因是:%d",e->m_cause); MessageBox("str"); file.Abort(); e->Delete(); } |
读取数据：
| BOOL ReadFile( HANDLE hFile, //文件的句柄 LPVOID lpBuffer, //用于保存读入数据的一个缓冲区 DWORD nNumberOfBytesToRead, //要读入的字符数 LPDWORD lpNumberOfBytesRead, //从文件中实际读入的字符数 LPOVERLAPPED lpOverlapped //如文件打开时指定了FILE_FLAG_OVERLAPPED，那么必须，用这个参数引用一个特殊的结构。该结构定义了一次异步读取操作。否则，应将这个参数设为NULL ); |
CFile的成员函数有：
| UINT Read (void* lpBuf,UINT nCount); throw(CFileException);// 返回值是传输到缓冲区的字节数。 |
写入数据：
| BOOL WriteFile( HANDLE hFile, //文件的句柄 LPCVOID lpBuffer, //要写入的一个数据缓冲区 DWORD nNumberOfBytesToWrite, //要写入数据的字节数量。如写入零字节，表示什么都不写入，但会更新文件的"上一次修改时间"。 LPDWORD lpNumberOfBytesWritten, //实际写入文件的字节数量 LPOVERLAPPED lpOverlapped // OVERLAPPED，倘若在指FILE_FLAG_OVERLAPPED的前提下打开文件，这个参数就必须引用一个特殊的结构。该结构定义了一次异步写操作。否则，该参数应置为NULL ); void Write(const void* lpBuf,UINT nCount); throw (CFileException); |
lpBuf：指向用户提供的缓冲区，包含将写入文件中的数据
nCount：从缓冲区内传输的字节数。对文本模式的文件，回车换行作为一个字符。
下面是象一个文件中写入数据的例子：
| CFile file; try { file.Open("d:/my.dat",CFile::modeCreate|CFile::modeWrite); file.SeekToBegin(); char Data[] = "111111111\n1111111111"; file.Write(Data,sizeof(Data)); file.Flush(); file.Close(); } catch(CFileException *e) { CString str; str.Format("读取数据失败的原因是:%d",e->m_cause); MessageBox("str"); file.Abort(); e->Delete(); } |
| BOOL GetFileTime( HANDLE hFile, // 文件句柄 LPFILETIME lpCreationTime, // 创建时间 LPFILETIME lpLastAccessTime, // 最后访问时间 LPFILETIME lpLastWriteTime // 最后写时间 ); BOOL SetFileTime( HANDLE hFile, CONST FILETIME *lpCreationTime, CONST FILETIME *lpLastAccessTime, CONST FILETIME *lpLastWriteTime ); typedef struct _FILETIME { DWORD dwLowDateTime; DWORD dwHighDateTime; } FILETIME; |
取得三个参数都是FILETIME结构，得到的都是UTC时间，可以通过API函数FileTimeToLocalFileTime（）和FileTimeToSystemTime()将他们转换为本地时间和系统时间格式，也可以通过LocalFileTimeToFileTime 和SystemTimeToFileTime()转换回来，通过SetFileTime设置文件的创建时间、最后访问时间、最后写时间。由于使用的时候要先打开文件，而且取得的最后访问时间就是当前时间，没有多大意义，且比较麻烦，下面介绍CFile类中的静态方法。
| static BOOL PASCAL GetStatus( LPCTSTR lpszFileName, CFileStatus& rStatus ); static void SetStatus( LPCTSTR lpszFileName, const CFileStatus& status ); throw( CFileException ); |
返回的是一个CfileStatus对象，这个结构的具体的成员变量包括：
| struct CFileStatus { CTime m_ctime; // 文件创建时间 CTime m_mtime; // 文件最近一次修改时间 CTime m_atime; // 文件最近一次访问时间 LONG m_size; // 文件大小 BYTE m_attribute; // 文件属性 BYTE _m_padding; // 没有实际含义，用来增加一个字节 TCHAR m_szFullName[_MAX_PATH]; //绝对路径 #ifdef _DEBUG //实现Dump虚拟函数，输出文件属性 void Dump(CDumpContext& dc) const; #endif }; |
下面就举一个例子来实现：
| CFileStatus status; char *path = "D:\\VSS"; if(CFile::GetStatus( path, status )) { CString cTime,mTime,aTime; cTime = status.m_ctime.Format("文件建立时间：%Y年%m月%d日 %H时%M分%S秒"); mTime = status.m_mtime.Format("文件最近修改时间：%Y年%m月%d日 %H时%M分%S秒"); aTime = status.m_atime.Format("文件最近访问时间：%Y年%m月%d日 %H时%M分%S秒"); CString str; str = cTime + "\n" + mTime +"\n" + aTime ; MessageBox(str); } |
4．取得和设置文件的属性
| DWORD GetFileAttributes( LPCTSTR lpFileName //文件或文件夹路经 ); BOOL SetFileAttributes( LPCTSTR lpFileName, // 文件名 DWORD dwFileAttributes // 要设置的属性 ); |
取得的文件属性包括：FILE_ATTRIBUTE_ARCHIVE，FILE_ATTRIBUTE_HIDDEN，FILE_ATTRIBUTE_NORMAL，FILE_ATTRIBUTE_OFFLINE，FILE_ATTRIBUTE_READONLY，FILE_ATTRIBUTE_SYSTEM，FILE_ATTRIBUTE_TEMPORARY
不能设置的文件属性包括有：FILE_ATTRIBUTE_COMPRESSED，FILE_ATTRIBUTE_DIRECTORY，FILE_ATTRIBUTE_ENCRYPTED，FILE_ATTRIBUTE_REPARSE_POINT，FILE_ATTRIBUTE_SPARSE_FILE，FILE_ATTRIBUTE_SYSTEM。
CFileStatus中也定义了一组属性：
| enum Attribute { normal, readOnly, hidden, system, volume, directory, archive }; |
可以通过if((status. m_attribute& readOnly) = =FILE_ATTRIBUTE_READONLY)来判断，这里利用另外的API来实现获得文件的详细信息：
| HANDLE FindFirstFile( LPCTSTR lpFileName, //文件或文件夹路经r LPWIN32_FIND_DATA lpFindFileData ); BOOL FindNextFile( HANDLE hFindFile, LPWIN32_FIND_DATA lpFindFileData ); BOOL FindClose(HANDLE hFindFile ); |
取得的是一个WIN32_FIND_DATA结构;
| typedef struct _WIN32_FIND_DATA { DWORD dwFileAttributes; //文件属性 FILETIME ftCreationTime; // 文件创建时间 FILETIME ftLastAccessTime; // 文件最后一次访问时间 FILETIME ftLastWriteTime; // 文件最后一次修改时间 DWORD nFileSizeHigh; // 文件长度高32位 DWORD nFileSizeLow; // 文件长度低32位 DWORD dwReserved0; // 系统保留 DWORD dwReserved1; // 系统保留 TCHAR cFileName[ MAX_PATH ]; // 长文件名 TCHAR cAlternateFileName[ 14 ]; // 8.3格式文件名 } WIN32_FIND_DATA, *PWIN32_FIND_DATA; |
也可以利用另外一个函数来取得文件的信息:
| BOOL GetFileInformationByHandle( HANDLE hFile, // 文件的句柄 LPBY_HANDLE_FILE_INFORMATION lpFileInformation ); |
函数填充的是BY_HANDLE_FILE_INFORMATION结构体:
| typedef struct _BY_HANDLE_FILE_INFORMATION { DWORD dwFileAttributes; FILETIME ftCreationTime; FILETIME ftLastAccessTime; FILETIME ftLastWriteTime; DWORD dwVolumeSerialNumber; // 文件所在的磁盘的序列号 DWORD nFileSizeHigh; DWORD nFileSizeLow; DWORD nNumberOfLinks; //链接的数目 DWORD nFileIndexHigh; DWORD nFileIndexLow; } BY_HANDLE_FILE_INFORMATION; |
下面就举一个例子来实现：
| HANDLE handle; WIN32_FIND_DATA find_data; handle = :: FindFirstFile("D:\\VSS",&find_data); FindClose(handle); find_data.dwFileAttributes = find_data.dwFileAttributes|FILE_ATTRIBUTE_READONLY; ::SetFileAttributes("D:\\VSS",find_data.dwFileAttributes); |
在上面的介绍中,除了可以设置文件的属性之外，在操作的过程当中也可以取得文件的其他一些信息，可以根据具体的需要来实现。
5．获取文件名,文件类型,文件长度,文件路径
用利用CFile打开一个文件时,可以在利用成员函数
| virtual CString GetFileName( ) const, virtual CString GetFileTitle( ) const, virtual CString GetFilePath( ) const, virtual DWORD GetLength( ) const;throw( CFileException ); |
来取得相关信息,如果一个文件的全路经是: c:\windows\write\myfile.wri,则每个函数取得的是: myfile.wri, myfile, c:\windows\write\myfile.wri. GetLength取得文件大小是按字节为单位的。
也可以利用：
| virtual void SetLength( DWORD dwNewLen );throw( CFileException ); virtual void SetFilePath( LPCTSTR lpszNewName ); |
来设置文件的长度和路径。
在当前的文件下面新建一个Text.txt文件，在里面写点东西，然后运行下面程序：
| CFile file("Text.txt",CFile::modeReadWrite); ULONGLONG length; CString strFilePath; length = file.GetLength(); length = length + 1024*10; file.SetLength(length); file.SetFilePath("D:\\Text.txt"); strFilePath = file.GetFilePath(); MessageBox(strFilePath); file.Close(); |
最后发现文件的路径变了，但是在D盘下面并没有找到Text.txt，原因是SetFilePath只能指定一个路径给文件，SetFilePath并不能做为移动文件来使用。
CFile并没有给出取得文件类型的函数，有了上面基础，这个很容易实现。
API函数中也有获得文件路径的操作，这里只是做简单介绍，可以参照MSDNN的说明：GetFileSize可以获得文件的大小，GetFullPathName 函数获取文件的完整路径名，只有当该文件在当前目录下，结果才正确。GetModuleFileName函数获取文件的完整路径名，这些函数有些用到文件句柄的。
用CFileDialog打开的文件,可以使用它的成员变量m_ofn,或者成员函数GetFileName, GetFileTitle, GetFilePath, GetFileExt来取得相关信息.
| CFileDialog( BOOL bOpenFileDialog, LPCTSTR lpszDefExt = NULL, LPCTSTR lpszFileName = NULL, DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT, LPCTSTR lpszFilter = NULL, CWnd* pParentWnd = NULL ); |
各个参数如下：
·bOpenFileDialog 为TRUE为打开对话框，为FALSE为保存对话文件对话框
·lpszDefExt 指定默认的文件扩展名。
·lpszFileName 指定默认的文件名。
·dwFlags 指明一些特定风格。
·lpszFilter它指明可供选择的文件类型和相应的扩展名。参数格式如：
"Chart Files (*.xlc)|*.xlc|Worksheet Files (*.xls)|*.xls|Data Files (*.xlc;*.xls)|*.xlc; *.xls|All Files (*.*)|*.*||";文件类型说明和扩展名间用 | 分隔，同种类型文件的扩展名间可以用 ; 分割，每种文件类型间用 | 分隔，末尾用 || 指明。
pParentWnd 为父窗口指针
| CString FileFilter = "所有文件(*.*)|*.*||"; CFileDialog FileDialog(true,NULL,NULL,OFN_HIDEREADONLY,FileFilter,NULL); FileDialog.DoModal(); MessageBox(FileDialog.GetFileName()); |
6．小结
在实际中还有很多其他操作文件的方法，上面介绍的只是简单的几种，希望通过上面的简单介绍，在加上具体实践，能够找到解决问题的最好办法！