インハムシステムの自動化ノート

現役エンジニアが、Excel VBA・Google Apps Scriptによる業務効率化のヒントをお届けします。

【Excel VBA】シート・ブック・ファイルの存在チェックでエラーを防ぐ方法

昨日まで動いていたマクロが、今日はエラーで止まった。原因を調べたら、誰かがシート名を「集計」から「集計表」に変えていた。

VBAのマクロは、対象が存在することを前提に書かれていることがほとんどです。そのため、シート名の変更やファイルの移動といった小さな変化で簡単に止まります。

この記事では、処理の前に「あるかどうか」を確認する書き方をまとめます。


シートが存在するか調べる

最も使用頻度が高いチェックです。汎用の関数として用意しておくと、どのマクロからも呼び出せます。

' シートが存在すれば True を返す
Function SheetExists(ByVal sheetName As String, _
                     Optional ByVal wb As Workbook) As Boolean
    Dim ws As Worksheet

    If wb Is Nothing Then Set wb = ThisWorkbook

    For Each ws In wb.Worksheets
        If ws.Name = sheetName Then
            SheetExists = True
            Exit Function
        End If
    Next ws

    SheetExists = False
End Function

使い方は次の通りです。

Sub UseSheetExists()
    If Not SheetExists("集計") Then
        MsgBox "「集計」シートが見つかりません。" & vbCrLf & _
               "シート名を確認してください。", vbExclamation
        Exit Sub
    End If

    ' ここから本来の処理
    ThisWorkbook.Worksheets("集計").Range("A1").Value = "開始"
End Sub

全シートを1つずつ照合する方式なので、エラー処理に頼らず確実に判定できます。第2引数を省略すると、マクロが書かれているブックを対象にします。

無ければ作る

チェックと作成をまとめておくと便利です。

' シートを取得する。存在しなければ新規作成して返す
Function GetOrCreateSheet(ByVal sheetName As String) As Worksheet
    If SheetExists(sheetName) Then
        Set GetOrCreateSheet = ThisWorkbook.Worksheets(sheetName)
    Else
        Dim ws As Worksheet
        Set ws = ThisWorkbook.Worksheets.Add( _
                    After:=ThisWorkbook.Worksheets(ThisWorkbook.Worksheets.Count))
        ws.Name = sheetName
        Set GetOrCreateSheet = ws
    End If
End Function
Sub UseGetOrCreate()
    Dim ws As Worksheet
    Set ws = GetOrCreateSheet("出力結果")

    ws.Cells.Clear
    ws.Range("A1").Value = "出力日時: " & Now
End Sub

出力先シートを毎回作る処理では、この形がよく使われます。


On Error Resume Next を使った書き方

より短く書く方法もあります。

Function SheetExists2(ByVal sheetName As String) As Boolean
    Dim ws As Worksheet

    On Error Resume Next
    Set ws = ThisWorkbook.Worksheets(sheetName)
    On Error GoTo 0              ' すぐに解除する

    SheetExists2 = Not ws Is Nothing
End Function

存在しないシートを指定するとエラーになる性質を利用し、エラーを無視して結果を見る方式です。

注意点は、On Error GoTo 0 で必ず元に戻すことです。 On Error Resume Next を書いたままにすると、そのプロシージャ内のすべてのエラーが無視されます。本来止まるべき不具合まで素通りしてしまい、原因の分からない誤動作につながります。

エラー無視は「1行だけ挟んで、すぐ解除する」という使い方に限定してください。


ファイル・フォルダの存在を調べる

Dir 関数を使います。

' ファイルが存在すれば True
Function FileExists(ByVal filePath As String) As Boolean
    If Len(Trim(filePath)) = 0 Then Exit Function
    FileExists = (Dir(filePath, vbNormal) <> "")
End Function

' フォルダが存在すれば True
Function FolderExists(ByVal folderPath As String) As Boolean
    If Len(Trim(folderPath)) = 0 Then Exit Function
    FolderExists = (Dir(folderPath, vbDirectory) <> "")
End Function

vbDirectory を指定しないとフォルダは判定できません。ここを間違えると、フォルダがあるのに「無い」と判定されます。

FileSystemObject を使う方法もあります。読みやすさを優先するならこちらです。

Function FileExistsFSO(ByVal filePath As String) As Boolean
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    FileExistsFSO = fso.FileExists(filePath)
End Function

Function FolderExistsFSO(ByVal folderPath As String) As Boolean
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    FolderExistsFSO = fso.FolderExists(folderPath)
End Function

無ければフォルダを作る

途中の階層も含めてまとめて作成する例です。

Sub CreateFolderDeep(ByVal folderPath As String)
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")

    If fso.FolderExists(folderPath) Then Exit Sub

    ' 親フォルダが無ければ先に作る(再帰)
    Dim parent As String
    parent = fso.GetParentFolderName(folderPath)

    If Len(parent) > 0 Then
        If Not fso.FolderExists(parent) Then CreateFolderDeep parent
    End If

    fso.CreateFolder folderPath
End Sub

MkDir は途中の階層が無いとエラーになりますが、この書き方なら C:\出力\2026\09 のような深い階層を一度に作れます。


ブックが開いているか調べる

すでに開いているブックを再度開こうとすると、警告が出たり編集内容が失われたりします。

' 指定した名前のブックが開いていれば True
Function IsBookOpen(ByVal bookName As String) As Boolean
    Dim wb As Workbook

    For Each wb In Application.Workbooks
        If StrComp(wb.Name, bookName, vbTextCompare) = 0 Then
            IsBookOpen = True
            Exit Function
        End If
    Next wb

    IsBookOpen = False
End Function

StrComp に vbTextCompare を指定すると、大文字小文字を区別せずに比較します。Windowsのファイル名は大文字小文字を区別しないため、この指定が適切です。

開いていれば使い、閉じていれば開く

Function GetWorkbook(ByVal filePath As String) As Workbook
    Dim fileName As String
    fileName = Dir(filePath)

    If fileName = "" Then
        MsgBox "ファイルが見つかりません:" & vbCrLf & filePath, vbExclamation
        Exit Function
    End If

    If IsBookOpen(fileName) Then
        Set GetWorkbook = Application.Workbooks(fileName)
    Else
        Set GetWorkbook = Application.Workbooks.Open(filePath)
    End If
End Function

別のフォルダにある同名ファイルが開いている場合、名前だけの判定では誤って別のブックを掴みます。厳密に判定するなら、フルパスで比較します。

Function IsBookOpenByPath(ByVal fullPath As String) As Boolean
    Dim wb As Workbook

    For Each wb In Application.Workbooks
        If StrComp(wb.FullName, fullPath, vbTextCompare) = 0 Then
            IsBookOpenByPath = True
            Exit Function
        End If
    Next wb
End Function

その他のチェック

名前の定義が存在するか

Function NameExists(ByVal nameStr As String) As Boolean
    Dim nm As Name

    For Each nm In ThisWorkbook.Names
        If nm.Name = nameStr Then
            NameExists = True
            Exit Function
        End If
    Next nm
End Function

セルに値が入っているか

Sub CheckCells()
    ' 空白かどうか
    If IsEmpty(Range("A1").Value) Then
        MsgBox "A1が未入力です"
    End If

    ' 数値かどうか
    If Not IsNumeric(Range("B1").Value) Then
        MsgBox "B1が数値ではありません"
    End If

    ' エラー値かどうか
    If IsError(Range("C1").Value) Then
        MsgBox "C1がエラーになっています"
    End If

    ' 範囲内にデータがあるか
    If WorksheetFunction.CountA(Range("A1:A1000")) = 0 Then
        MsgBox "データがありません"
    End If
End Sub

テーブル(ListObject)が存在するか

Function TableExists(ByVal ws As Worksheet, ByVal tableName As String) As Boolean
    Dim lo As ListObject

    For Each lo In ws.ListObjects
        If lo.Name = tableName Then
            TableExists = True
            Exit Function
        End If
    Next lo
End Function

実行前にまとめて確認する

処理の途中で止まると、中途半端な状態のデータが残ります。必要な条件は、処理を始める前にまとめて確認するのが安全です。

Sub MainProcess()
    Dim errMsg As String

    ' --- 事前チェック ---
    If Not SheetExists("入力") Then
        errMsg = errMsg & "・「入力」シートがありません" & vbCrLf
    End If

    If Not SheetExists("マスタ") Then
        errMsg = errMsg & "・「マスタ」シートがありません" & vbCrLf
    End If

    If Not FolderExists("C:\出力") Then
        errMsg = errMsg & "・出力先フォルダ C:\出力 がありません" & vbCrLf
    End If

    If SheetExists("入力") Then
        If WorksheetFunction.CountA(Worksheets("入力").Range("A2:A10000")) = 0 Then
            errMsg = errMsg & "・「入力」シートにデータがありません" & vbCrLf
        End If
    End If

    ' --- 1件でも問題があれば中止する ---
    If Len(errMsg) > 0 Then
        MsgBox "処理を開始できません。" & vbCrLf & vbCrLf & errMsg, vbExclamation
        Exit Sub
    End If

    ' --- ここから本処理 ---
    Call ExecuteMain
End Sub

問題を1つずつではなくまとめて提示するのがポイントです。「シートがありません」と直したら次は「フォルダがありません」と出る、という往復を避けられます。


まとめ

  • シートの存在確認は、全シートを照合する関数を1つ作って使い回す
  • On Error Resume Next は1行だけ挟み、On Error GoTo 0 ですぐ解除する
  • フォルダの判定には Dir(パス, vbDirectory) を使う
  • ブックが開いているかは、名前ではなくフルパスで比較すると確実
  • 必要な条件は処理前にまとめて確認し、問題があれば一覧で伝える

「エラーが出たら直す」ではなく「エラーになる前に止める」形にしておくと、自分以外の人に渡すマクロとして安心して使えるようになります。


他の記事でもExcel VBAの実務的なテクニックを紹介していますので、ぜひチェックしてみてください。