Dir函式

Dir函式是檔案名稱、目錄名或資料夾名稱，搭配指定的模式或檔案屬性。

基本介紹

• 中文名：Dir函式
• 外文名：pathname
• 定義：檔案名稱、目錄名或資料夾名稱
• 搭配：指定的模式或檔案屬性
• 可選參數：pathname 
• 參數的設定：常數 值 描述

Dir函式 返回

返回一個 String，用以表示一個檔案名稱、目錄名或資料夾名稱，它必須與指定的模式或檔案屬性、或磁碟卷標相匹配。

語法

Dir[(pathname[, attributes])]

Dir 函式的語法具有以下幾個部分：

部分 描述

pathname 可選參數。用來指定檔案名稱的字元串表達式，可能包含目錄或資料夾、以及驅動器。如果沒有找到 pathname，則會返回零長度字元串 ("")。

attributes 可選參數。常數或數值表達式，其總和用來指定檔案屬性。如果省略，則會返回匹配 pathname 但不包含屬性的檔案。

設定值

attributes 參數的設定可為：

常數 值 描述

vbNormal 0 (預設) 指定沒有屬性的檔案。

vbReadOnly 1 指定無屬性的唯讀檔案

vbHidden 2 指定無屬性的隱藏檔案

VbSystem 4 指定無屬性的系統檔案

vbVolume 8 指定卷標檔案；如果指定了其它屬性，則忽略vbVolume

vbDirectory 16 指定無屬性檔案及其路徑和資料夾。

注意 這些常數是由 VBA 所指定的，在程式代碼中的任何位置，可以使用這些常數來替換真正的數值。

說明

Dir 支持多字元 (*) 和單字元 (?) 的通配符來指定多重檔案。

由於 Macintosh 不支持通配符，使用檔案類型指定檔案組。可以使用 MacID 函式指定檔案類型而不用檔案名稱。比如，下列語句返回當前資料夾中第一個TEXT檔案的名稱:

Dir("SomePath", MacID("TEXT"))

為選中資料夾中所有檔案，指定一空串:

Dir("")

在 Microsoft Windows 中，如果在Dir函式中使用MacID函式，將產生錯誤。

任何大於256的attribute值都被認為是MacID 函式的值。

在第一次調用 Dir 函式時，必須指定 pathname，否則會產生錯誤。如果也指定了檔案屬性，那么就必須包括 pathname。

Dir 會返回匹配 pathname 的第一個檔案名稱。若想得到其它匹配 pathname 的檔案名稱，再一次調用 Dir，且不要使用參數。如果已沒有合乎條件的檔案，則 Dir 會返回一個零長度字元串 ("")。一旦返回值為零長度字元串，並要再次調用 Dir 時，就必須指定 pathname，否則會產生錯誤。不必訪問到所有匹配當前 pathname 的檔案名稱，就可以改變到一個新的 pathname 上。但是，不能以遞歸方式來調用 Dir 函式。以 vbDirectory 屬性來調用 Dir 不能連續地返回子目錄。

提示 由於檔案名稱並不會以特別的次序來返回，所以可以將檔案名稱存儲在一個數組中，然後再對這個數組排序。