解讀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
 

2．檔案的讀寫定位

　　定位檔案中的資料是很重要的，這決定了寫入的資料在檔案中的位置。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(); }

3．取得和設定檔案的建立時間、最後訪問時間、最後寫時間

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．小結

　　在實際中還有很多其他動作檔案的方法，上面介紹的只是簡單的幾種，希望通過上面的簡單介紹，在加上具體實踐，能夠找到解決問題的最好辦法！