非IT企業に勤める中年サラリーマンのIT日記

非IT企業でしかもITとは全く関係ない部署にいる中年エンジニア。唯一の趣味がプログラミングという”自称”プログラマー。

【ExcelVBA】処理対象フォルダを設定シートから変更できるようにする方法

   

Excel VBAマクロを開発していると、特定のフォルダ内のファイルを処理することがよくあります。
しかし、処理対象のフォルダパスを直接コードに書き込んでしまうと、フォルダが変わるたびにコードを修正する必要があり、非常に手間がかかります。
この記事では、処理対象フォルダのパスをExcelシート上から設定できるようにする方法を解説します。これにより、コードを一切変更することなく、柔軟に処理対象フォルダを切り替えられるようになります。

設定シートの準備

まずは、フォルダパスを設定するためのシートを用意しましょう。
新しいシートを作成し、「設定」などの分かりやすい名前に変更します。
例えば、A1セルに「処理対象フォルダパス:」、B1セルに実際のフォルダパス(例: C:\Users\YourName\Documents\TargetFolder)を入力します。
このB1セルからパスを読み取るようにVBAコードを記述します。

(↑「設定」シートのB1セルに処理対象フォルダパスを入力した状態)

フォルダパスを読み込むVBAコード

設定シートからフォルダパスを読み取る基本的なVBAコードを紹介します。
ここでは、B1セルに設定されたパスをtargetFolderPath変数に格納し、メッセージボックスで表示する例です。

Sub ReadFolderPathFromSettings()
    Dim targetFolderPath As String

    On Error GoTo ErrorHandler

    ' "設定"シートのB1セルからフォルダパスを読み込む
    targetFolderPath = ThisWorkbook.Sheets("設定").Range("B1").Value

    ' 読み込んだパスを表示(確認用)
    MsgBox "設定されたフォルダパス: " & targetFolderPath, vbInformation, "パス確認"

    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました。設定シート名やセル番地を確認してください。", vbCritical, "エラー"
End Sub
 
コードの解説
  • ThisWorkbook.Sheets("設定"): 現在のブック内の「設定」という名前のシートを指定します。
  • .Range("B1").Value: 指定したシートのB1セルの値を取得します。
  • MsgBox: 取得したパスをメッセージボックスで表示して確認します。
  • On Error GoTo ErrorHandler: エラーが発生した場合に、ErrorHandlerラベルへ処理をジャンプさせ、エラーメッセージを表示します。

読み込んだフォルダパスを利用するサンプル

次に、実際に読み込んだフォルダパスを使って、そのフォルダ内のファイル一覧を取得するサンプルコードを紹介します。
この例では、指定したフォルダ内のすべてのファイル名をイミディエイトウィンドウに表示します。

Sub ListFilesInTargetFolder()
    Dim targetFolderPath As String
    Dim fso As Object ' FileSystemObject
    Dim targetFolder As Object ' Folder Object
    Dim file As Object ' File Object

    ' エラーハンドリング
    On Error GoTo ErrorHandler

    ' 1. 設定シートからフォルダパスを読み込む
    '    ※ このプロシージャを実行する前に、"設定"シートのB1セルに有効なフォルダパスを入力してください
    targetFolderPath = ThisWorkbook.Sheets("設定").Range("B1").Value

    ' フォルダパスが空でないか、または存在するか確認
    If targetFolderPath = "" Then
        MsgBox "設定シートのB1セルにフォルダパスが入力されていません。", vbExclamation, "エラー"
        Exit Sub
    End If

    Set fso = CreateObject("Scripting.FileSystemObject")

    If Not fso.FolderExists(targetFolderPath) Then
        MsgBox "指定されたフォルダは存在しません: " & targetFolderPath, vbExclamation, "エラー"
        Set fso = Nothing ' オブジェクトを解放
        Exit Sub
    End If

    ' 2. 読み込んだフォルダパスを使ってファイル一覧を取得する
    Set targetFolder = fso.GetFolder(targetFolderPath)

    Debug.Print "--- フォルダ内のファイル一覧 (" & targetFolderPath & ") ---"
    If targetFolder.Files.Count > 0 Then
        For Each file In targetFolder.Files
            Debug.Print " - " & file.Name
        Next file
    Else
        Debug.Print "フォルダ内にファイルはありません。"
    End If
    Debug.Print "--------------------------------------------------"

    MsgBox "ファイル一覧をイミディエイトウィンドウに出力しました。", vbInformation, "完了"

    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "エラー"
    ' エラー発生時もオブジェクトを解放
    Set fso = Nothing
    Set targetFolder = Nothing
    Set file = Nothing
End Sub
 
コードの解説
  • CreateObject("Scripting.FileSystemObject"): ファイルやフォルダを操作するためのFileSystemObjectを作成します。これを使うことで、フォルダの存在確認やファイル一覧の取得が可能になります。
  • fso.FolderExists(targetFolderPath): 指定したパスのフォルダが存在するかどうかを確認します。存在しない場合はエラーメッセージを表示し、処理を中断します。
  • fso.GetFolder(targetFolderPath): 指定したパスのフォルダオブジェクトを取得します。
  • For Each file In targetFolder.Files: 取得したフォルダ内の各ファイルに対してループ処理を行います。
  • Debug.Print file.Name: ファイルの名前をVBEのイミディエイトウィンドウに出力します。
  • Set fso = Nothing など: 使用したオブジェクトは、処理の終了時やエラー発生時にNothingを設定してメモリを解放することが推奨されます。

まとめ

設定シートからフォルダパスを読み込むことで、VBAマクロの柔軟性が大幅に向上します。

処理対象のフォルダが変わってもコードを修正する必要がないため、運用が非常に楽になります。

このテクニックは、フォルダパスだけでなく、ファイル名、シート名、各種設定値など、様々な外部設定に活用できます。

スポンサーリンク

 - Excel, VBA