VBAを使うとフォルダ内の全てフォルダやファイル名を取得して一覧にすることができます。
これは下位フォルダ(サブフォルダ)のファイルも含めて全て取得可能です。
実際、エクセルにフォルダ名とファイル名を取得するプログラムは以下のページで紹介しています。
しかしフォルダ名とファイル名をテキストファイルに書き出すことも可能です。
このページでは「VBA×フォルダファイル操作」の事例として、フォルダ名とファイル名をテキストファイルに書き出すVBAプログラムについて紹介します。
・VBAサンプルを無料ダウンロード
それでは以下で詳しく紹介していきます。
目次
- 1 概要｜VBAで下位フォルダも含めて全フォルダ・全ファイルの名前をテキストファイルに出力
- 2 手順｜VBAで下位フォルダも含めて全フォルダ・全ファイルの名前をテキストファイルに出力
- 3 VBA入りのエクセルファイルをダウンロード
- 4 VBA作成前の2つの事前準備
- 5 VBAのプログラムソース解説
- 5.1 プログラム0｜変数宣言の指定
- 5.2 プログラム1-1｜メインプログラム開始
- 5.3 プログラム1-2｜FileSystemObjectの設定
- 5.4 プログラム1-3｜シートの設定
- 5.5 プログラム1-4｜情報を取得するフォルダパスを取得
- 5.6 プログラム1-5｜テキストファイルを読み込む
- 5.7 プログラム1-6｜サブプログラムを呼び出す(2-1を呼び出す)
- 5.8 プログラム1-7｜オブジェクト解放
- 5.9 プログラム1-8｜プログラム終了
- 5.10 プログラム2-1｜サブプログラム開始
- 5.11 プログラム2-2｜FileSystemObjectの設定
- 5.12 プログラム2-3｜フォルダを取得
- 5.13 プログラム2-4｜フォルダ内のフォルダを取得
- 5.14 プログラム2-5｜フォルダ内のファイルを取得
- 5.15 プログラム2-6｜オブジェクト解放
- 5.16 プログラム2-7｜プログラム終了
- 6 Excel VBAについて詳しく理解したいなら
- 7 VBAを自分で書けるようになる
概要｜VBAで下位フォルダも含めて全フォルダ・全ファイルの名前をテキストファイルに出力
下位フォルダも含めてのフォルダ名とファイル名をテキストファイルを書き出します。
VBAでテキストファイルとフォルダを操作する事例として良い教材ですので、勉強の一つとしてお使いいただくのが良いかと思います。
他の事例として、VBAでフォルダ名とファイル名を取得してエクセルに書き出すプログラムも以下で紹介しています。
興味がある人はご覧ください。
手順｜VBAで下位フォルダも含めて全フォルダ・全ファイルの名前をテキストファイルに出力
手順2. VBAプログラムを実行
テキストファイルからフォルダを作成するVBAプログラムは、VBAプログラム実行前にいくつか準備することがあります。
手順1. エクセルのセルB2にフォルダパスを入力
セルB2にテキストファイルに一覧をしたい「フォルダパス」を入力します。
セルB2にフォルダパスが入力されていないと、本プログラムを実行しても強制終了されます。
手順2. VBAプログラムを実行
VBAプログラムを実行します。
これでVBAを実行すると、テキストファイルにフォルダ名とファイル名を書き出します。
ボタンにVBAプログラムを登録する方法
本ページではVBAプログラムをボタンに登録しています。
ボタンにVBAプログラムを登録することで、ボタンを押下しプログラムを実行することができます。
ボタンをVBAプログラムを設定したい場合は、以下で動画も交えて設定方法を紹介しているので、そちらをご覧ください。
それでは、以下でプログラムについて詳細を説明します。
VBA入りのエクセルファイルをダウンロード
以下で紹介しているVBAプログラムをそのまま使いたい人は、以下のフォームからダウンロードできます。
登録したメールアドレスへ「VBAプログラムが含まれたエクセル」を送信します。
本プログラムの内容をそのまま使用可能です。ぜひお仕事にお役立てください。
それでは、以下でプログラムについて詳細を説明します。
VBA作成前の2つの事前準備
ExcelでVBAを使うためにはいくつかの準備が必要です。
具体的には以下です。
2. フォルダとファイルを扱うための事前準備
上記の2つに関して、以下で説明します。
1. ExcelでVBAを使うための事前準備
Excelで、以下の2つの準備をします。
2. 開発タブを追加
保存ファイルの拡張子変更、Excelの基本設定変更の2つです。
2つともで難しい作業はなく、それぞれ1分もあれば設定変更可能です。
上記に関しては、以下の記事で解説をしています。
もしVBAを使うための準備段階に不安がある人は上記をご覧ください。
この内容は以下の動画で紹介しています。
入門エクセルマクロの使い方｜マクロ作成から実行までを徹底解説
文字や画像だけで分かりづらい人は上記の動画をご覧ください。
2. フォルダとファイルを扱うための事前準備
VBAでフォルダやファイルを操作するためのプログラミングに入る前に、VBAの設定を変更しておく必要があります。
実はVBAのデフォルト設定の場合、フォルダやファイル操作はできません。
なぜなら、参照設定が変更だからです。参照設定とは、機能拡張させることです。
参照設定を変更することで、フォルダとファイルを操作できるようになります。
この記事で紹介するプログラムを使えるようにするには、以下の参照設定を変更します。
「Microsoft Scripting Runtime」にチェックを入れることで、添付ファイルを保存するフォルダを作成することができるようになります。
VBAの参照設定の方法
以下、具体的な設定方法を紹介します。
手順2.Microsoft Scripting Runtimeのライブラリにチェックを入れて、OKをクリック
詳細はこちらの画像の通りです。
手順1.VBEを開いて頂いて、「ツール」→「参照設定」
手順2.Microsoft Scripting Runtimeのライブラリにチェックを入れて、OKをクリック
上記の設定をしていないと、本事例で紹介しているプログラムは動作しません。
必ずチェックを入れるようにします。
VBAのプログラムソース解説
今回紹介するプログラムの概要は以下です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 |
'プログラム0｜変数宣言の強制 Option Explicit 'プログラム1-1｜メインプログラム開始 Sub Main() 'プログラム1-2｜FileSystemObjectの設定 Dim fs As Scripting.FileSystemObject Set fs = New Scripting.FileSystemObject 'プログラム1-3｜シートの設定 Dim ws As Worksheet Set ws = worksheets("Sheet1") 'プログラム1-4｜情報を取得するフォルダパスを取得 Dim path As String path = ws.Range("B2").Value If fs.FolderExists(folderspec:=path) = False Then MsgBox ("正しいフォルダパスを入力してください") Exit Sub End If 'プログラム1-5｜テキストファイルを読み込む Dim txtpath As String Dim txt As TextStream txtpath = ThisWorkbook.path & "\00_FoldersFilesName.txt" fs.CreateTextFile txtpath Set txt = fs.OpenTextFile(filename:=txtpath, IOMode:=ForWriting) 'プログラム1-6｜サブプログラムを呼び出す(2-1を呼び出す) Call GetSubFoldersFilesName(txt, path, 0) 'プログラム1-7｜オブジェクト解放 Set txt = Nothing Set fs = Nothing 'プログラム1-8｜プログラム終了 End Sub 'プログラム2-1｜サブプログラム開始 Sub GetSubFoldersFilesName(txt, path, i) 'プログラム2-2｜FileSystemObjectの設定 Dim fs As Scripting.FileSystemObject Set fs = New Scripting.FileSystemObject 'プログラム2-3｜フォルダを取得 Dim basefolder As Scripting.Folder Set basefolder = fs.GetFolder(path) 'プログラム2-4｜フォルダ内のフォルダを取得 Dim myfolders As Scripting.Folders Set myfolders = basefolder.SubFolders Dim myfolder As Scripting.Folder For Each myfolder In myfolders txt.WriteLine (String(i, vbTab) & "フォルダ：" & myfolder.Name) Call GetSubFoldersFilesName(txt, myfolder.path, i + 1) Next 'プログラム2-5｜フォルダ内のファイルを取得 Dim myfiles As Scripting.Files Set myfiles = basefolder.Files Dim myfile As Scripting.File For Each myfile In myfiles txt.WriteLine (String(i, vbTab) & "ファイル：" & myfile.Name) Next 'プログラム2-6｜オブジェクト解放 Set myfile = Nothing Set myfiles = Nothing Set myfolder = Nothing Set myfolders = Nothing Set basefolder = Nothing Set fs = Nothing 'プログラム2-7｜プログラム終了 End Sub |
以下で詳しく説明しています。
プログラム0｜変数宣言の指定
|
1 |
Option Explicit |
「Option Explicit」とは、変数宣言を強制するためのものです。
これを入れておくと、変数を定義していない場合、エラーが出ます。
つまり、「Option Explicit」を入力しておくことで、たとえば「Dim i」をあらかじめ入力しないと、「i」という変数を使えません。
もし「Option Explicit」を入力しているのに、「Dim i」を書かずに「i = 1」と書くと、エラーメッセージが表示されます。
実は、この機能はあくまでオプションです。「Option Explicit」を入力しなくても、プログラムは動きます。
しかし、これを入れておくことで、変数の誤記によるエラーを防止することができます。
結果的に、プログラム作成速度が上がるので、「Option Explicit」を入力することを習慣化することをオススメします。
プログラム1-1｜メインプログラム開始
|
1 |
Sub Main() |
「Sub Main()」のプログラムを開始することを意味します。
VBAではプロシージャという単位でプログラムを呼び出します。
プロシージャの構文は下記となっています。
|
1 2 3 |
Sub プロシージャ名() '実行プログラム End Sub |
「Sub」で始まり「End Sub」で終わります。
「Sub XXXX」の「XXXX」の部分がプロシージャ名です。
このプロシージャ名はあらゆる文字（アルファベット、ひらがな、漢字、数字など）が使用可能です。
ただし、プロシージャ名の先頭は数字を入れるとエラーとなります。
あとで見たときに、「何のプログラムだったのか？」とならないようにするためです。
なお、「()」の中には何も記入されていません。これは引数なしという意味です。なお、プログラム2-1では引数を受け取ってプログラムを実行します。
初心者の内は、引数ということが分からなくてもVBAプログラムを書くことは可能です。
興味があれば、「VBA 引数」で検索して調べてみてください。
プログラム1-2｜FileSystemObjectの設定
|
1 2 |
Dim fs As Scripting.FileSystemObject Set fs = New Scripting.FileSystemObject |
FileSystemObjectは、ファイルやフォルダを操作するときに使うオブジェクトです。
本事例ではFileSystemObjectをfsという変数として扱います。
変数fsは定義するだけではなく、「Set fs = New Scripting.FileSystemObject」と記入して使えるようになります。
これを忘れてしまうことが多いので、注意が必要です。
FileSystemObjectに関する注意点
参照設定にて、Microsoft Scripting Runtimeを設定に入れておく必要があります。
設定を忘れると動作しませんので、事前に設定を変更しておく必要があります。
なお、FileSystemObject以外にもフォルダを操作する方法はあります。しかしFileSystemObjectを使えば、ファイルとフォルダを両方操作できるので、覚えることが少なくて済みます。
細かいことを覚えるのが面倒な人は、ファイルやフォルダを操作するときはFileSystemObjectを使うと覚えておくといいです。
プログラム1-3｜シートの設定
|
1 2 |
Dim ws As Worksheet Set ws = Worksheets("Sheet1") |
Excelの「Sheet1」シートをwsとして扱います。
プログラム1-4｜情報を取得するフォルダパスを取得
|
1 2 3 4 5 6 |
Dim path As String path = ws.Range("B2").Value If fs.FolderExists(folderspec:=path) = False Then MsgBox ("正しいフォルダパスを入力してください") Exit Sub End If |
セルB2にはフォルダパス(情報を取得したいフォルダ)があらかじめ入力されているため、その値をpath(String文字列型)として取得します。
しかしセルB2にフォルダパスが入力されていなかったり、パスが正しくなかったりする場合があります。
そこで「If fs.FolderExists(folderspec:=folderpath) = False Then」で、もしセルB2の値がフォルダパスでないとき、エラーメッセージを表示するようにします。
エラーメッセージ表示後に、「Exit Sub」でプログラムを強制終了させます。
プログラム1-5｜テキストファイルを読み込む
|
1 2 3 4 5 |
Dim txtpath As String Dim txt As TextStream txtpath = path & "\00_FoldersFilesName.txt" fs.CreateTextFile txtpath Set txt = fs.OpenTextFile(filename:=txtpath, IOMode:=ForWriting) |
フォルダ情報を書き出すためのテキストファイルを新しく作成します。
txtpathで、エクセルファイルと同じフォルダに「00_FoldersFilesName.txt」という名前のテキストファイルを生成します。
この時点ではテキストファイルを作成するだけであり、何も記載されていません。
プログラム2-4とプログラム2-5で、テキストファイルに情報を書き込んでいきます。
プログラム1-6｜サブプログラムを呼び出す(2-1を呼び出す)
|
1 |
Call GetSubFoldersFilesName(txt, path, 0) |
プログラム2-1を呼び出します。
このとき、(txt, path, 0)の要素をプログラム2-1に渡します。
|
1 2 3 4 5 |
'プログラム1-6｜サブプログラムを呼び出す(2-1を呼び出す) Call GetSubFoldersFilesName(txt, path, 0) 'プログラム2-1｜サブプログラム開始 Sub GetSubFoldersFilesName(txt, path, i) |
上記のように3つの要素がそれぞれ記載されています。
それぞれの()内の要素はプログラム1-6とプログラム2-1で順番通りに対応しています。
実はこれはプログラム1-4(txt, path, 0)をプログラム2-1の(txt, path, i)に引き継がせることを意味しています。
1.「プログラム2-1のtxt」=「プログラム1-2のtxt」
2.「プログラム2-1のpath」=「プログラム1-3のpath」
3.「プログラム2-1のi」=「0」
ここでは引き継ぐ要素は3つです。そのため、引き継ぐ要素数に過不足があるとエラーが出ます。
たとえば引き継ぐ要素が2つや4つだとプログラムが停止します。
このプログラム1-6でプログラム2-1を呼び出すため、次はプログラム2-1に移行し処理が行われます。
Callで他のプログラムを実行
他のプログラムを実行するときは以下のように「Call Subプロシージャ名()」で呼び出すことが可能です。
|
1 2 |
'他のプログラムを実行するときの書き方 Call Subプロシージャ() 'Callは書かなくてもOK |
「Call」は記載がなくても問題ありません。
プログラム1-7｜オブジェクト解放
|
1 2 |
Set txt = Nothing Set fs = Nothing |
ファイルとFileSystemObjectに関するオブジェクトを解放します。
プログラム1-8｜プログラム終了
|
1 |
End Sub |
プログラム1-1と対になるプログラムで、プログラム終了させるための記述です。
「End Sub」を読み込むと、プログラム1-1が終了します。
なお今回のプログラムが複数存在するため、2つの「End Sub」が存在します。
プログラム2-1｜サブプログラム開始
|
1 |
Sub GetSubFoldersFilesName(txt, path, i) |
「Sub GetSubFoldersFilesName(txt, path, i)」で、3つの要素を引き継いでプログラムを実行します。
このとき3つの引数(引き継ぐ値)は以下のとおりです。
2. path：情報を取得するフォルダパス
3. i：タブスペースの数(フォルダ階層の数×タブスペース)
このプログラム2-1は、プログラム1-6およびプログラム2-4から呼び出されます。
プログラム2-1はフォルダ階層が1つ深くなるたびに呼び出されるようにしています。
たとえば、セルB2で入力したフォルダパスに2つの下位フォルダがあれば、プログラム2-1は合計3回(親フォルダ,下位フォルダ2つ)呼び出されることになります。
このような処理(フォルダの階層ごとに同じ処理を行うこと)を、再帰的な処理と呼ぶことがあります。
プログラム2-2｜FileSystemObjectの設定
|
1 2 |
Dim fs As Scripting.FileSystemObject Set fs = New Scripting.FileSystemObject |
FileSystemObjectは、ファイルやフォルダを操作するときに使うオブジェクトです。
プログラム1-2でも同じ記述がありますが、サブプログラムの中で使用するFileSystemObjectは別で設定する必要があります。
よって面倒ですが、あらためてFileSystemObjectを設定します。
プログラム2-3｜フォルダを取得
|
1 2 |
Dim basefolder As Scripting.Folder Set basefolder = fs.GetFolder(path) |
変数basefolderをScripting.Folderとして扱います。
「Set basefolder = fs.GetFolder(path)」で、basefolderにpath(プログラム2-1で引き継いだ値)で設定したフォルダパスを設定します。
プログラム2-4｜フォルダ内のフォルダを取得
|
1 2 3 4 5 6 7 |
Dim myfolders As Scripting.Folders Set myfolders = basefolder.SubFolders Dim myfolder As Scripting.Folder For Each myfolder In myfolders txt.WriteLine (String(i, vbTab) & "フォルダ：" & myfolder.Name) Call GetSubFoldersFilesName(txt, myfolder.path, i + 1) Next |
pathで指定したフォルダ内に含まれるフォルダを取得していきます。
「myfolder.Name」でフォルダ名を取得できるため、「フォルダ：myfolder.Name」をテキストファイルへ書き込みます。(画像のとおり)
このとき、「String(i, vbTab)」でタブスペースをi個分入れ込みます。このようにすることで、フォルダ階層分だけタブスペースを入れ込むことができます。
「Call GetSubFoldersFilesName(txt, myfolder.path, i + 1)」でプログラム2-1を呼び出します。
ここでプログラム2-1を呼び出すことで、下位フォルダの情報を取りに行きます。引き継ぐ3つの要素は以下のとおりです。
引数：テキストファイル
→プログラム1-5で設定したtxtをそのまま引数として渡す
引数：下位フォルダのフォルダパス
→下位フォルダに対して処理を行うため、「myfolder.path」で下位フォルダのパスを引数として渡す
引数：タブスペースの数を渡す
→1つ階層が深くなると、1つタブスペースを増やすため、「i+1」とする
「Next」まで処理が進んだら、「For Each myfolder In myfolders」に戻って次のフォルダに対して処理を行います。
プログラム2-5｜フォルダ内のファイルを取得
|
1 2 3 4 5 6 |
Dim myfiles As Scripting.Files Set myfiles = basefolder.Files Dim myfile As Scripting.File For Each myfile In myfiles txt.WriteLine (String(i, vbTab) & "ファイル：" & myfile.Name) Next |
セルB2で指定したフォルダ内に含まれるファイルを取得していきます。
「myfile.Name」でファイル名を取得できるため、「ファイル：myfile.Name」としてテキストファイルに書き込みます。(画像のとおり)
なおプログラム2-4とは違い、「Call GetSubFoldersFilesName(txt, myfolder.path, i + 1)」のようにプログラム2-1を呼び出すことはしません。
理由はプログラム2-5がファイルを対象にしているからです。
フォルダのように下位にフォルダやファイルが存在しないため、再帰的に呼び出す必要はありません。
プログラム2-6｜オブジェクト解放
|
1 2 3 4 5 6 |
Set myfile = Nothing Set myfiles = Nothing Set myfolder = Nothing Set myfolders = Nothing Set basefolder = Nothing Set fs = Nothing |
ここまで使用してきたFileSystemObjectに関する6つのオブジェクトを解放します。
VBAの場合、このプログラム9がなくてもエラーは表示されません。
しかし今後、他のプログラミング言語を学んでいくと、この解放作業が求められることは少なくありません。
そのため、ここでお作法として身に着けておくことをお勧めします。
プログラム2-7｜プログラム終了
|
1 |
End Sub |
プログラム2-1と対になるプログラムで、プログラム終了させるための記述です。
「End Sub」を読み込むと、プログラムが終了します。
プログラムの解説はここまでです。
Excel VBAについて詳しく理解したいなら
VBAを活用すると、仕事を効率化できる幅を広げることができます。
たとえば私が実際にVBAを活用して効率化してきた作業は以下の記事で紹介しています。
興味がある人は以下の記事もご覧ください。
動画でも解説しています。
エクセルマクロVBAで出来ることを15の事例で紹介｜日常業務をラクにするヒントを見つけよう！
(音声が小さいので、ボリュームを上げてご覧いただければと思います)
VBAの勉強方法
私はプログラミング初心者からVBAを勉強を始めて少しずつレベルアップしていきました。
成長の過程は以下で紹介しています。
学習の過程では、意識すべきポイントがあります。
特に独学の場合だと、勉強を優先してしまい、肝心な実践を疎かにしがちです。
私の経験では、実践から逆算した勉強が必要だと考えています。
目指すべきは会社でお金をもらいながら勉強することです。
要はVBAを仕事の一つとして上司に認めてもらうのです。
そうすればわざわざ高いお金を払って勉強をする必要がなくなります。
しかも作業を自動化して、会社やチームに貢献しつつ、自らのスキルアップできます。
そのために必要な考え方を以下で紹介しています。
とはいえ、プログラミング初心者でVBAについて知識ゼロの人もいるはずです。
いきなり会社でVBAで使うことさえ、とてつもなくハードルが高く見えてしまうものです。
その場合は、VBAの基本について学ぶ必要があります。
たとえば車の運転も慣れてしまえば、たいしたことではありません。
しかし教習所で運転の基本を学び、免許を取得することで、公道で運転できるようになります。
VBAも同じです。VBAに免許はありませんが、まずは基本を学ばないことには会社で使えるレベルにはなりません。
実際に私もプログラミング初心者のときは、動画を見たり書籍を読んだりして勉強しました。
今はオンラインの教材で無料で学習できるものも多いです。
上記のリンクでは、私の経験から勉強にオススメの教材を紹介しています。
興味がある人はご覧ください。
VBAを自分で書けるようになる
さて、本記事で紹介したマクロを利用すれば、作業の自動化が可能になります。
しかしデメリットもあります。それはカスタムできないことです。
なぜなら、色々な要望が増えるからです。
この動画を見たとき、「もっと○○ができるのでは？」や「ここはなんとかならないのか」と感じる人は少なくないはずです。
例えば、「他の条件を付け加えたい」や「日付毎に条件を変えたい」といった要望が出るかもしれません。
このような要望を満たすには、マクロを勉強して自力でマクロを編集できるようになる必要があります。
もし、自力でマクロを編集できるようになれば、今より仕事の効率はグッと上がります。
実際、私も自力でマクロを書けるようになってからは、仕事の生産性が一気に上がりました。
他の人が30分～1時間かけて行う仕事が、ボタン一つで終わらせることができるようになったのです。
その結果、周囲からの信頼も増し、仕事で高い評価を得られるようになりました。
ただ、要望に応えるようになるためには、マクロを学ぶ必要があります。
まずは無料でマクロを勉強してみる
ウェブや書籍で勉強すれば、マクロを習得できると考えている人は少なくありません。
しかし、仕事で使えるマクロを習得したいなら、仕事で使える部分に特化した教材で学ぶことをお勧めします。
なぜなら、ウェブや書籍には仕事に関係しない部分まで提供していることが多いからです。
例えば、マクロ初心者なのに配列を学ぼうとする人がいます。実は配列なしでも仕事で使えるマクロを書くことは可能です。
しかし、マクロ初心者ほど「全ての知識が必要だ」と考えて、無駄な学習に時間を使ってしまうのです。詳しくは、こちらの記事で紹介しています。
そこで、私がお勧めするのは仕事に直結するマクロ教材です。とくにお勧めするのは、こちらの無料オンライン動画です。
なぜなら、仕事に直結する部分に絞って、エクセルマクロを学ぶことができるからです。
マクロの作り方・考え方から解説しているので、教材をしっかり学べばここで紹介したマクロをゼロから書けるようになります。
マクロ初心者が、仕事に直結したいマクロを学ぶなら、まずはこちらの無料オンライン動画を試すのがいいです。
興味がある人は、まずは無料でエクセルマクロの勉強を始めてみてください。
もっと学びたいと感じたら、さらに深く勉強をしてみることをお勧めします。