【VBAリファレンス】VBA入門ファイル操作Ⅰ(Dir)

スポンサーリンク
スポンサーリンク

1. VBA入門ファイル操作Ⅰ(Dir)的定義と基本構文

VBAのDir関数は、指定されたパス内のファイルやディレクトリをリストするための重要なツールです。以下に、基本的な使用方法と構文を説明します。

1. Dir 関数の使用

Dir 関数は、次のような形式で使用されます:

Dir [StartDirectory], [Attributes]

[StartDirectory]: ディレクトリパスを指定する必要があります。例えば、”C:\Example\Subfolder” など。
[Attributes]: ファイル属性(例:”*.*” で全てのファイルをリストする)を指定することができます。

2. 基本構文

以下に、Dir を活用するための基本的なVBA構文を示します。

‘ ディレクトリ内のすべての項目をリストする例
For Each obj In Dir(“C:\Example\Subfolder”)
Debug.Print obj.Name
Next

3. 注意事項

– Dir 関数は、一時的なアクセス権を必要とします。
– 実稼働環境で重要なデータを操作する際には、適当なセキュリティ対策を実施してください。

以上が、VBA入門者向けのファイル操作(Dir)についての基本情報です。

2. VBA入門ファイル操作Ⅰ(Dir)的基本例題(サンプルコード)

VBAのFile Handling機能を学ぶと、ディレクトリ内のファイルやフォルダーの管理が重要なテーマです。以下に、基本的な操作の例を示します。

1. ディレクトリ内のファイルを確認する方法

‘ 現在のディレクトリ内をリストする
Dim filesAndFolders As Collection
Dim directory As String

directory = “C:\Users\YourName\Documents” ‘ 替換: ユーザー自身のドキュメントフォルダーに適したパスを入力します
Set filesAndFolders = Application.CurrentProject.path & “\Files and Folders”

For Each item In filesAndFolders
If item.Name Like “*.*” Then
MsgBox “ファイル名: ” & item.Name & vbCrLf & “種類: ” & item.Type, vbOKOnly + vbInformation
End If
Next

2. 新規テキストファイルを作成する方法

‘ 新しいテキストファイルを作成する
Dim fso As FileSystemObject
Dim txtFile As TextFile

Set fso = CreateObject(“ScriptFile”)
fso.CreateTextFile “sample.txt”, “”, False, “”
Set txtFile = fso.OpenTextFile(“sample.txt”)

With txtFile
.Write “サンプル”
End With
txtFile.Close

3. ファイルを削除する方法

‘ 特定のファイルを削除する(警告を表示)
Dim fso As FileSystemObject

Set fso = CreateObject(“ScriptFile”)
fso.Delete “C:\Users\YourName\Documents\sample.txt”, True ‘ 削除確認を求めるためTrueを使用します

注意事項:
– ファイル操作は慎重に行ななければならないため、削除や上書きはユーザーに警告する必要があります。
– VBAのFile Handling機能は、非常に強力なツールですので、適当に管理してください。

3. 実務で役立つ応用パターン

VBAでのFile Handling操作は、開発者が日々に扱う重要なタスクです。以下に、実務で役立つ具体的な応用パターンを列挙します。

1. ディレクトリ内のファイル一覧作成
– Dir 関数を使用して、指定したディレクトリ内のすべてのファイルとサブディレクトリをリストアップすることができます。
– 例:


     Dim arrFiles As Collection
     Set arrFiles = CreateObject("ScriptFiles")
     For i = 0 To arrFiles.Count - 1
         strFileName = arrFiles.Item(i).Name
         ' ファイル名を加工し、必要な情報を抽取することができます。
     Next
     

– メリット: ディレクトリ構成を可視化し、ファイル操作を容易にします。

2. 特定拡張名のファイルのみを処理
– 拡張名(.ext)を指定して、該ファイルのみを対象に作業することができます。
– 例:


     Dim strTargetExt As String = "csv"
     For i = 0 To Dir(strPath, vbDirectory + vbImplicitWait) - 1
         strFileName = Dir(i, strTargetExt)
         ' 特定拡張名のファイルに対する操作を実施します。
     Next
     

– メリット: 対象ファイルのみに制限し、処理が高速化します。

3. 重名ファイルを移動
– 重名ファイルが存在する場合、自動的に上書きまたは移動を行うことができます。
– 例:


     Dim strSourcePath As String = "source\test.txt"
     Dim strDestinationPath As String = "destination\test.txt"
     If Dir(strDestinationPath, vbDirectory + vbImplicitWait) Then
         CopyFile strSourcePath, strDestinationPath
     Else
         MoveFile strSourcePath, strDestinationPath
     End If
     

– メリット: 重名ファイルの存在を考慮し、操作が安全に行けます。

4. ディレクトリ情報取得
– ファイル属性(サイズ、権限など)を確認することができるため、管理が容易になります。
– 例:


     Dim strPath As String = "C:\test\"
     If Dir(strPath, vbDirectory + vbImplicitWait) Then
         For i = 0 To Dir(strPath, vbDirectory + vbImplicitWait) - 1
             strFileName = Dir(i, "")
             ' ファイル属性を確認することができます。
             MsgBox "ファイル名: " & strFileName & vbCrLf & "サイズ: " & FileSize(strFileName)
         Next
     End If
     

– メリット: ディレクトリ内の情報を一目で確認できるので、管理が効率的です。

以上の応用パターンは、VBAでのファイル操作を実務

4. コードの1行ずつ詳細解説

VBA で ファイル操作に関連する基本的な コード を 学びます。本節では、ディレクトリ(フォルダー)内の ファイルや フォルダーの 取り込みや 操作について示します。

1. ファイル名を取得する

Dim FileName As String
FileName = ThisWorkbook.ActiveSheet.Range(“A1”).Value

– ThisWorkbook.ActiveSheet.Range(“A1”) で セル A1 の 值 を 取り込む。
– FileName に 取り込まれた値が ファイル名 となります。

2. 現在の プロジェクト パスを取得する

Dim CurrentProjectPath As String
CurrentProjectPath = ThisWorkbook.Path

– ThisWorkbook.Path で 現在の プロジェクト ファイル が保存されている ディレクトリ パス を 取り込む。
– 使用例: CurrentProjectPath = ThisWorkbook.Path & “\Subfolder\FileName.xlsx”
– ただし、& は文字通り に 使用せず、Join 関数や CombinePath 関数を 推奨します。

3. 特定の フォルダー を 削除する

Dim FolderName As String
FolderName = “Subfolder”
If Dir(FolderName, True) Then
Kill Today’sReport:=”Subfolder\*.xlsx”
End If

– Dir(“Subfolder”, True) で フォルダー “Subfolder” が存在するかどうかを 確認します。
– 存在すれば、Kill コマンドで 属する ファイル を 一律 削除します。

4. ディレクトリ内の ファイル を 列挙する

Dim FileList As String
FileList = “”
For Each File In Dir(“C:\”, True)
If InStr(File, “.xlsx”) > 0 Then
FileList = FileList & File & vbCrLf
End If
End For

– Dir(“C:\”, True) で ルート ディレクトリ内の ファイル を 列挙します。
– InStr(File, “.xlsx”) で .xlsx 形式の ファイルのみを 取り込む.

5. 特定の フォルダー を 作成する

Dim FolderName As String
FolderName = “NewFolder”
If Not Dir(FolderName, False) Then
MkDir FolderName
End If

– Dir(FolderName, False) で フォルダー が 存在しないかどうかを 確認します。
– 存在しなければ、MkDir で 新規 フォルダー を 作成します。

6. ファイルの 最終更新日時を 取り込む

Dim LastModifiedTime As String
LastModifiedTime = FileDateTime(”

使用上の注意点とエラー対策

VBAでのファイル操作は、適当な権限やパーミションを確認する必要があります。以下に、重要な注意事項とエラー対策について説明します。

注意事項
1. ファイル存在確認: ファイルやディレクトリが存在することを必ず確認し、Dir(“パスワード”)のようなメソッドを使用して実施します。
2. 権限とパーミション: 実行する操作に必要な権限を確認し、適当な許可を得る必要があります。未認可の操作は禁止です。
3. バックアップ:重要なデータはバックアップをし、操作前に実施しておきます。

エラー対策
1. エラー判定: VBAでは、OnErrorイベントを使用して、予期しないエラーが発生した場合に適当な処理を実施できます。
2. メッセージ表示: エラー内容をユーザーに明示するため、MsgBox関連のメソッドを使用します。
3. **再試験: 必要に応じて、エラーが直径的に原因となった操作を再度実行することができます。

‘ ファイル存在確認
If Dir(“C:\ExampleFolder”) = 0 Then
MsgBox “ディレクトリが存在しません”
End If

‘ ファイル読み取り
Open “C:\ExampleFile.txt” For Reading As String
Close

‘ 替代ファイル名の使用
Dim fileName As String
fileName = “新しいファイル名” & Date
Open fileName, OverWrite=True

タイトルとURLをコピーしました