VBA×ファイル操作｜フォルダ名とファイル名をテキストファイルへ出力

フォルダ内のファイルやフォルダ名を書き出したいときがあります。

このときVBAを使うと、フォルダ名とファイル名の一覧を入手することができます。

実際、エクセルにフォルダ名とファイル名を取得するプログラムは以下のページで紹介しています。

しかしフォルダ名とファイル名をテキストファイルに書き出すことも可能です。

そこでこのページではVBA×フォルダファイル操作の事例として、フォルダ名とファイル名をテキストファイルに書き出すVBAプログラムについて紹介します。

それでは以下で詳しく紹介していきます。

概要｜VBAでフォルダ名とファイル名を取得してテキストファイルに出力

所定のフォルダ内のサブフォルダ名とファイル名をテキストファイルを書き出します。

VBAでテキストファイルとフォルダを操作する事例として良い教材ですので、勉強の一つとしてお使いいただくのが良いかと思います。

他の事例として、VBAでフォルダ名とファイル名を取得してエクセルに書き出すプログラムも以下で紹介しています。

以下は下位フォルダも含めて全てのフォルダ名とファイル名を取得して、エクセルに書き出すプログラムです。

興味がある人はご覧ください。

手順｜VBAでフォルダ名とファイル名を取得してテキストファイルに出力

テキストファイルからフォルダを作成するVBAプログラムは、VBAプログラム実行前にいくつか準備することがあります。

手順1. エクセルのセルB2にフォルダパスを入力

セルB2にテキストファイルに一覧をしたい「フォルダパス」を入力します。

セルB2にフォルダパスが入力されていないと、本プログラムを実行しても強制終了されます。

手順2. VBAプログラムを実行

VBAプログラムを実行します。

これでVBAを実行すると、テキストファイルにフォルダ名とファイル名を書き出します。

ボタンにVBAプログラムを登録する方法

本ページではVBAプログラムをボタンに登録しています。

ボタンにVBAプログラムを登録することで、ボタンを押下しプログラムを実行することができます。

ボタンをVBAプログラムを設定したい場合は、以下で動画も交えて設定方法を紹介しているので、そちらをご覧ください。

それでは、以下でプログラムについて詳細を説明します。

VBA入りのエクセルファイルをダウンロード

以下で紹介しているVBAプログラムをそのまま使いたい人は、以下のフォームからダウンロードできます。

登録したメールアドレスへ「VBAプログラムが含まれたエクセル」を送信します。

本プログラムの内容をそのまま使用可能です。ぜひお仕事にお役立てください。

それでは、以下でプログラムについて詳細を説明します。

VBA作成前の2つの事前準備

ExcelでVBAを使うためにはいくつかの準備が必要です。

具体的には以下です。

上記の2つに関して、以下で説明します。

1. ExcelでVBAを使うための事前準備

Excelで、以下の2つの準備をします。

保存ファイルの拡張子変更、Excelの基本設定変更の2つです。

2つともで難しい作業はなく、それぞれ1分もあれば設定変更可能です。

上記に関しては、以下の記事で解説をしています。

もしVBAを使うための準備段階に不安がある人は上記をご覧ください。

この内容は以下の動画で紹介しています。

入門エクセルマクロの使い方｜マクロ作成から実行までを徹底解説

文字や画像だけで分かりづらい人は上記の動画をご覧ください。

2. フォルダとファイルを扱うための事前準備

VBAでフォルダやファイルを操作するためのプログラミングに入る前に、VBAの設定を変更しておく必要があります。

実はVBAのデフォルト設定の場合、フォルダやファイル操作はできません。

なぜなら、参照設定が変更だからです。参照設定とは、機能拡張させることです。

参照設定を変更することで、フォルダとファイルを操作できるようになります。

この記事で紹介するプログラムを使えるようにするには、以下の参照設定を変更します。

「Microsoft Scripting Runtime」にチェックを入れることで、添付ファイルを保存するフォルダを作成することができるようになります。

VBAの参照設定の方法

以下、具体的な設定方法を紹介します。

詳細はこちらの画像の通りです。

手順1.VBEを開いて頂いて、「ツール」→「参照設定」

手順2.Microsoft Scripting Runtimeのライブラリにチェックを入れて、OKをクリック

上記の設定をしていないと、本事例で紹介しているVBAプログラムは動作しません。

必ずチェックを入れるようにします。

VBAのプログラムソース解説

今回紹介するプログラムの概要は以下です。

以下で詳しく説明しています。

プログラム0｜変数宣言の指定

「Option Explicit」とは、変数宣言を強制するためのものです。

これを入れておくと、変数を定義していない場合、エラーが出ます。

つまり、「Option Explicit」を入力しておくことで、たとえば「Dim i」をあらかじめ入力しないと、「i」という変数を使えません。

もし「Option Explicit」を入力しているのに、「Dim i」を書かずに「i = 1」と書くと、エラーメッセージが表示されます。

実は、この機能はあくまでオプションです。「Option Explicit」を入力しなくても、プログラムは動きます。

しかし、これを入れておくことで、変数の誤記によるエラーを防止することができます。

結果的に、プログラム作成速度が上がるので、「Option Explicit」を入力することを習慣化することをオススメします。

プログラム1｜プログラム開始

「Sub WriteFoldersAndFilesName_ToText()」のプログラムを開始することを意味します。

VBAではプロシージャという単位でプログラムを呼び出します。

プロシージャの構文は下記となっています。

「Sub」で始まり「End Sub」で終わります。

「Sub XXXX」の「XXXX」の部分がプロシージャ名です。

このプロシージャ名はあらゆる文字（アルファベット、ひらがな、漢字、数字など）が使用可能です。

ただし、プロシージャ名の先頭は数字を入れるとエラーとなります。

あとで見たときに、「何のプログラムだったのか？」とならないようにするためです。

なお、「()」の中には何も記入されていません。これは引数なしという意味です。

初心者の内は、引数ということが分からなくてもVBAプログラムを書くことは可能です。

興味があれば、「VBA 引数」で検索して調べてみてください。

プログラム2｜シート設定

変数wsをWorksheet(ワークシート)型で設定します。

変数wsにExcelのシート「Sheet1」を設定します。

以降、wsでワークシートを操作します。

プログラム3｜FileSystemObjectの設定

FileSystemObjectは、ファイルやフォルダを操作するときに使うオブジェクトです。

本事例ではFileSystemObjectをfsという変数として扱います。

変数fsは定義するだけではなく、「Set fs = New Scripting.FileSystemObject」と記入して使えるようになります。

これを忘れてしまうことが多いので、注意が必要です。

FileSystemObjectに関する注意点

なお参照設定にて、Microsoft Scripitng Runtimeを設定に入れておく必要があります。

設定を忘れると動作しませんので、事前に設定を変更しておく必要があります。

なお、FileSystemObject以外にもフォルダを操作する方法はあります。しかしFileSystemObjectを使えば、ファイルとフォルダを両方操作できるので、覚えることが少なくて済みます。

細かいことを覚えるのが面倒な人は、ファイルやフォルダを操作するときはFileSystemObjectを使うと覚えておくといいです。

プログラム4｜セルB2のファイルパスを取得

セルB2にはフォルダパス(情報を取得したいフォルダ)があらかじめ入力されているため、その値をfolderpath(String文字列型)として取得します。

しかしセルB2にフォルダパスが入力されていなかったり、パスが正しくなかったりする場合があります。

そこで「If fs.FolderExists(folderspec:=folderpath) = False Then」で、もしセルB2の値がフォルダパスでないとき、エラーメッセージを表示するようにします。

エラーメッセージ表示後に、「Exit Sub」でプログラムを強制終了させます。

プログラム5｜テキストファイルを読み込む

フォルダ情報を書き出すためのテキストファイルを新しく作成します。

txtpathで、エクセルファイルと同じフォルダに「00_FoldersFilesName.txt」という名前のテキストファイルを生成します。

プログラム7とプログラム8で、テキストファイルに情報を書き込んでいきます。

プログラム6｜フォルダを取得

変数basefolderをScripting.Folderとして扱います。

「Set basefolder = fs.GetFolder(folderpath)」で、basefolderにfolderpath(プログラム4)で設定したフォルダパスを設定します。

これでfolderpath(セル2で指定したフォルダ)の中のサブフォルダやファイルを取得できるようになります。

プログラム7｜フォルダ内のフォルダを取得

セルB2で指定したフォルダ内に含まれるフォルダを取得していきます。

「myfolder.Name」でフォルダ名を取得できるため、「フォルダ myfolder.Name」をテキストファイルへ書き込みます。(画像のとおり)

プログラム8｜フォルダ内のファイルを取得

セルB2で指定したフォルダ内に含まれるファイルを取得していきます。

「myfile.Name」でファイル名を取得できるため、「フォルダ myfile.Name」としてテキストファイルに書き込みます。(画像のとおり)

プログラム9｜オブジェクト解放

フォルダとファイルに関するオブジェクトを解放します。

VBAの場合、このプログラムがなくてもエラーは表示されません。

しかし今後、他のプログラミング言語を学んでいくと、この解放作業が求められることは少なくありません。

そのため、お作法として身に着けておくことをお勧めします。

プログラム10｜テキストファイルを閉じる

テキストファイルを閉じます。

プログラム11｜オブジェクト解放

ファイルとFileSystemObjectに関するオブジェクトを解放します。

プログラム12｜プログラム終了

プログラム1と対になるプログラムで、プログラム終了させるための記述です。

「End Sub」を読み込むと、プログラムが終了します。

プログラムの解説はここまでです。

Excel VBAについて詳しく理解したいなら

VBAを活用すると、仕事を効率化できる幅を広げることができます。

たとえば私が実際にVBAを活用して効率化してきた作業は以下の記事で紹介しています。

興味がある人は以下の記事もご覧ください。

動画でも解説しています。

エクセルマクロVBAで出来ることを15の事例で紹介｜日常業務をラクにするヒントを見つけよう！

(音声が小さいので、ボリュームを上げてご覧いただければと思います)

VBAの勉強方法

私はプログラミング初心者からVBAを勉強を始めて少しずつレベルアップしていきました。

成長の過程は以下で紹介しています。

→私のVBA習得の道のり（10ヶ月でVBA取得するまで）

学習の過程では、意識すべきポイントがあります。

特に独学の場合だと、勉強を優先してしまい、肝心な実践を疎かにしがちです。

私の経験では、実践から逆算した勉強が必要だと考えています。

目指すべきは会社でお金をもらいながら勉強することです。

要はVBAを仕事の一つとして上司に認めてもらうのです。

そうすればわざわざ高いお金を払って勉強をする必要がなくなります。

しかも作業を自動化して、会社やチームに貢献しつつ、自らのスキルアップできます。

そのために必要な考え方を以下で紹介しています。

→VBAを作成するときに覚えておきたい18のコツ

とはいえ、プログラミング初心者でVBAについて知識ゼロの人もいるはずです。

いきなり会社でVBAで使うことさえ、とてつもなくハードルが高く見えてしまうものです。

その場合は、VBAの基本について学ぶ必要があります。

たとえば車の運転も慣れてしまえば、たいしたことではありません。

しかし教習所で運転の基本を学び、免許を取得することで、公道で運転できるようになります。

VBAも同じです。VBAに免許はありませんが、まずは基本を学ばないことには会社で使えるレベルにはなりません。

実際に私もプログラミング初心者のときは、動画を見たり書籍を読んだりして勉強しました。

今はオンラインの教材で無料で学習できるものも多いです。

上記のリンクでは、私の経験から勉強にオススメの教材を紹介しています。

興味がある人はご覧ください。

VBAを自分で書けるようになる

さて、本記事で紹介したマクロを利用すれば、作業の自動化が可能になります。

しかしデメリットもあります。それはカスタムできないことです。

なぜなら、色々な要望が増えるからです。

この動画を見たとき、「もっと○○ができるのでは？」や「ここはなんとかならないのか」と感じる人は少なくないはずです。

例えば、「他の条件を付け加えたい」や「日付毎に条件を変えたい」といった要望が出るかもしれません。

このような要望を満たすには、マクロを勉強して自力でマクロを編集できるようになる必要があります。

もし、自力でマクロを編集できるようになれば、今より仕事の効率はグッと上がります。

実際、私も自力でマクロを書けるようになってからは、仕事の生産性が一気に上がりました。

他の人が30分～1時間かけて行う仕事が、ボタン一つで終わらせることができるようになったのです。

その結果、周囲からの信頼も増し、仕事で高い評価を得られるようになりました。

ただ、要望に応えるようになるためには、マクロを学ぶ必要があります。

まずは無料でマクロを勉強してみる

ウェブや書籍で勉強すれば、マクロを習得できると考えている人は少なくありません。

しかし、仕事で使えるマクロを習得したいなら、仕事で使える部分に特化した教材で学ぶことをお勧めします。

なぜなら、ウェブや書籍には仕事に関係しない部分まで提供していることが多いからです。

例えば、マクロ初心者なのに配列を学ぼうとする人がいます。実は配列なしでも仕事で使えるマクロを書くことは可能です。

しかし、マクロ初心者ほど「全ての知識が必要だ」と考えて、無駄な学習に時間を使ってしまうのです。詳しくは、こちらの記事で紹介しています。

そこで、私がお勧めするのは仕事に直結するマクロ教材です。とくにお勧めするのは、こちらの無料オンライン動画です。

なぜなら、仕事に直結する部分に絞って、エクセルマクロを学ぶことができるからです。

マクロの作り方・考え方から解説しているので、教材をしっかり学べばここで紹介したマクロをゼロから書けるようになります。

マクロ初心者が、仕事に直結したいマクロを学ぶなら、まずはこちらの無料オンライン動画を試すのがいいです。

興味がある人は、まずは無料でエクセルマクロの勉強を始めてみてください。

もっと学びたいと感じたら、さらに深く勉強をしてみることをお勧めします。