HOW TO：在 Visual Basic 中將具有特定模式的檔案複製到目錄

發行項
08/15/2011

GetFiles 方法會傳回代表檔案的路徑名稱之字串的唯讀集合。您可以使用 wildCards 參數，指定特定的模式。

如果找不到相對應的檔案，則傳回空集合。

您可以使用 CopyFile 方法，將檔案複製到目錄。

若要將具有特定模式的檔案複製到目錄

使用 GetFiles 方法，傳回檔案清單。這個範例會傳回指定之目錄中的所有 .rtf 檔。

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
    My.Computer.FileSystem.SpecialDirectories.MyDocuments,
    Microsoft.VisualBasic.FileIO.SearchOption.SearchTopLevelOnly, "*.rtf")

使用 CopyFile 方法，複製檔案。這個範例會將檔案複製到名為 testdirectory 的目錄。

My.Computer.FileSystem.CopyFile(foundFile, "C:\testdirectory\" & My.Computer.FileSystem.GetName(foundFile))

以 Next 陳述式 (Statement) 關閉 For 陳述式。
```
Next
```

範例

以下範例會將上述程式碼片段整理為完整格式，可複製指定之目錄中的所有 .rtf 檔，再傳送至名為 testdirectory 的目錄。

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
    My.Computer.FileSystem.SpecialDirectories.MyDocuments,
    Microsoft.VisualBasic.FileIO.SearchOption.SearchTopLevelOnly, "*.rtf")

    My.Computer.FileSystem.CopyFile(foundFile, "C:\testdirectory\" & foundFile)
Next

安全性

以下條件可能會造成例外狀況：

路徑無效，由於下列原因之一：它是零長度字串，它僅包含空白，它包含無效的字元，或它是一個設備路徑（以開始 \\。 \) (ArgumentException).
路徑無效，因為它是 Nothing (ArgumentNullException)。
目錄不存在 (DirectoryNotFoundException)。
目錄會指向現有的檔案 (IOException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式 (NotSupportedException)。
使用者缺乏必要的使用權限來檢視路徑 (SecurityException)。使用者缺乏必要的使用權限 (UnauthorizedAccessException)。