OpenFileDialog

[C#] OpenFileDialogでファイルパスを取得する方法

2025-01-18更新日: 2025-01-18

C#でOpenFileDialogを使用してファイルパスを取得するには、まずSystem.Windows.Forms名前空間をインポートします。

次に、OpenFileDialogクラスのインスタンスを作成し、ShowDialogメソッドを呼び出してダイアログを表示します。

ユーザーがファイルを選択して「開く」をクリックすると、DialogResult.OKが返され、選択されたファイルのパスはFileNameプロパティから取得できます。

目次から探す

ファイルパスの取得方法
エラーハンドリング
- ファイル選択キャンセル時の処理
- 無効なファイルパスの処理
応用例
まとめ

ファイルパスの取得方法

ShowDialogメソッドの使用

OpenFileDialogを使用する際、最初に行うべきはShowDialogメソッドの呼び出しです。

このメソッドは、ファイル選択ダイアログを表示し、ユーザーがファイルを選択することを可能にします。

以下は、ShowDialogメソッドを使用した基本的なコード例です。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFile()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        // ダイアログを表示し、ユーザーがファイルを選択した場合
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            // 選択されたファイルのパスを取得
            string filePath = openFileDialog.FileName; 
            // 取得したファイルパスを表示
            MessageBox.Show("選択されたファイル: " + filePath); 
        }
    }
}

このコードでは、OpenFileDialogのインスタンスを作成し、ShowDialogメソッドを呼び出しています。

ユーザーがファイルを選択すると、選択されたファイルのパスが取得され、メッセージボックスに表示されます。

FileNameプロパティの取得

ユーザーがファイルを選択した後、選択されたファイルのパスはFileNameプロパティを通じて取得できます。

このプロパティは、OpenFileDialogのインスタンスに対して使用されます。

以下のコードは、FileNameプロパティを使用してファイルパスを取得する方法を示しています。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFile()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            string filePath = openFileDialog.FileName; // FileNameプロパティからファイルパスを取得
            MessageBox.Show("選択されたファイル: " + filePath); // 取得したファイルパスを表示
        }
    }
}

このコードでは、ユーザーが選択したファイルのパスをFileNameプロパティを使用して取得し、メッセージボックスに表示しています。

複数ファイルのパス取得

OpenFileDialogを使用して複数のファイルを選択することも可能です。

その場合、Multiselectプロパティをtrueに設定します。

以下のコードは、複数のファイルを選択し、それらのパスを取得する方法を示しています。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFiles()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        openFileDialog.Multiselect = true; // 複数ファイル選択を許可
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            // 選択されたファイルのパスを取得
            string[] filePaths = openFileDialog.FileNames; 
            // 取得したファイルパスを表示
            foreach (string filePath in filePaths)
            {
                MessageBox.Show("選択されたファイル: " + filePath); 
            }
        }
    }
}

このコードでは、Multiselectプロパティをtrueに設定することで、ユーザーが複数のファイルを選択できるようにしています。

選択されたファイルのパスはFileNamesプロパティを使用して取得し、各ファイルパスをメッセージボックスで表示しています。

エラーハンドリング

ファイル選択キャンセル時の処理

ユーザーがファイル選択ダイアログを開いた際、選択をキャンセルすることがあります。

この場合、ShowDialogメソッドはDialogResult.Cancelを返します。

キャンセルされた場合の処理を適切に行うことで、アプリケーションの安定性を保つことができます。

以下は、キャンセル時の処理を含むコード例です。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFile()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        // ダイアログを表示し、ユーザーがファイルを選択した場合
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            string filePath = openFileDialog.FileName; // 選択されたファイルのパスを取得
            MessageBox.Show("選択されたファイル: " + filePath); // 取得したファイルパスを表示
        }
        else
        {
            // ユーザーがキャンセルした場合の処理
            MessageBox.Show("ファイル選択がキャンセルされました。"); 
        }
    }
}

このコードでは、ユーザーがファイル選択をキャンセルした場合に、メッセージボックスでその旨を通知しています。

これにより、ユーザーに対して明確なフィードバックを提供できます。

無効なファイルパスの処理

ユーザーが選択したファイルが無効な場合、例えばファイルが存在しない、またはアクセス権がない場合には、適切なエラーハンドリングが必要です。

以下のコードは、無効なファイルパスを処理する方法を示しています。

using System;
using System.IO;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFile()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            string filePath = openFileDialog.FileName; // 選択されたファイルのパスを取得
            // ファイルが存在するか確認
            if (File.Exists(filePath))
            {
                MessageBox.Show("選択されたファイル: " + filePath); // 取得したファイルパスを表示
            }
            else
            {
                // ファイルが存在しない場合の処理
                MessageBox.Show("選択されたファイルは存在しません。"); 
            }
        }
    }
}

このコードでは、File.Existsメソッドを使用して、選択されたファイルが存在するかどうかを確認しています。

ファイルが存在しない場合には、エラーメッセージを表示することで、ユーザーに問題を通知します。

これにより、無効なファイルパスに対する適切な対応が可能になります。

応用例

ファイルの内容を表示する

選択したファイルの内容を表示することは、ユーザーにとって非常に便利な機能です。

以下のコードは、テキストファイルを選択し、その内容をメッセージボックスに表示する方法を示しています。

using System;
using System.IO;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFileAndDisplayContent()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "テキストファイルを選択"; // ダイアログのタイトルを設定
        openFileDialog.Filter = "テキストファイル (*.txt)|*.txt"; // テキストファイルのみ表示
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            string filePath = openFileDialog.FileName; // 選択されたファイルのパスを取得
            // ファイルの内容を読み込む
            string fileContent = File.ReadAllText(filePath); 
            // 読み込んだ内容を表示
            MessageBox.Show("ファイルの内容:\n" + fileContent); 
        }
    }
}

このコードでは、選択されたテキストファイルの内容をFile.ReadAllTextメソッドを使用して読み込み、メッセージボックスに表示しています。

選択したファイルをコピーする

ユーザーが選択したファイルを別の場所にコピーする機能も便利です。

以下のコードは、選択したファイルを指定したディレクトリにコピーする方法を示しています。

using System;
using System.IO;
using System.Windows.Forms;
public partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void OpenFileAndCopy()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            string sourceFilePath = openFileDialog.FileName; // 選択されたファイルのパスを取得
            string destinationPath = @"C:\コピー先\" + Path.GetFileName(sourceFilePath); // コピー先のパスを設定
            // ファイルをコピー
            File.Copy(sourceFilePath, destinationPath, true); // 既存のファイルを上書きする場合はtrueを指定
            MessageBox.Show("ファイルがコピーされました: " + destinationPath); 
        }
    }
}

このコードでは、選択されたファイルを指定したディレクトリにコピーしています。

Path.GetFileNameメソッドを使用して、元のファイル名を保持したままコピー先のパスを作成しています。

ファイルパスをテキストボックスに表示する

選択したファイルのパスをテキストボックスに表示することで、ユーザーが選択したファイルを確認しやすくなります。

以下のコードは、選択したファイルのパスをテキストボックスに表示する方法を示しています。

using System;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private TextBox filePathTextBox; // テキストボックスを宣言
    public MyForm()
    {
        InitializeComponent();
        filePathTextBox = new TextBox(); // テキストボックスのインスタンスを作成
        filePathTextBox.Location = new System.Drawing.Point(10, 10); // テキストボックスの位置を設定
        filePathTextBox.Width = 300; // テキストボックスの幅を設定
        Controls.Add(filePathTextBox); // フォームにテキストボックスを追加
    }
    private void OpenFileAndDisplayPath()
    {
        OpenFileDialog openFileDialog = new OpenFileDialog(); // OpenFileDialogのインスタンスを作成
        openFileDialog.Title = "ファイルを選択"; // ダイアログのタイトルを設定
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            string filePath = openFileDialog.FileName; // 選択されたファイルのパスを取得
            filePathTextBox.Text = filePath; // テキストボックスにファイルパスを表示
        }
    }
}