はじめに

Windows Forms アプリケーションでファイルを選択する際、OpenFileDialog は非常に便利なコントロールです。この記事では、OpenFileDialog で最も基本的なプロパティの一つである FileName プロパティについて、初心者の方にもわかりやすく解説します。FileName プロパティを使うことで、ユーザーが選択したファイルのパスを簡単に取得したり、初期値を設定したりすることができます。具体的なコード例を交えながら、その使い方を見ていきましょう。

OpenFileDialog とは？
FileName プロパティとは？
FileName プロパティの使い方 (コード例)
まとめ

OpenFileDialog とは？

OpenFileDialog は、Windows の標準的なファイル選択ダイアログを表示するためのコントロールです。ユーザーは、このダイアログを使ってファイルシステムからファイルを選択し、そのファイルを開いたり、アプリケーションで利用したりできます。

FileName プロパティとは？

FileName プロパティは、OpenFileDialog で選択されたファイルのフルパス (ファイル名とディレクトリ) を文字列として取得または設定するためのプロパティです。

取得: ユーザーがファイルを選択した後、FileName プロパティから選択されたファイルのパスを取得できます。
設定: OpenFileDialog を表示する前に FileName プロパティに値を設定することで、ダイアログを開いた際に特定のファイルが初期選択された状態にできます。

FileName プロパティの使い方 (コード例)

OpenFileDialog の基本

まず、OpenFileDialog をフォームに追加し、基本的な設定を行います。

using System;
using System.Windows.Forms;

namespace OpenFileDialogSample
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
        }

        private void openButton_Click(object sender, EventArgs e)
        {
            OpenFileDialog openFileDialog = new OpenFileDialog();
            openFileDialog.Title = "ファイルを開く";
            openFileDialog.Filter = "テキストファイル(*.txt)|*.txt|すべてのファイル(*.*)|*.*";
            openFileDialog.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

            if (openFileDialog.ShowDialog() == DialogResult.OK)
            {
                // ここで FileName プロパティから選択されたファイルパスを取得
                string filePath = openFileDialog.FileName;
                MessageBox.Show("選択されたファイル: " + filePath);
            }
        }
    }
}

実行例

解説:

using System.Windows.Forms;
OpenFileDialog を使うために必要な名前空間をインポートします。
OpenFileDialog openFileDialog = new OpenFileDialog();: OpenFileDialog のインスタンスを作成します。
openFileDialog.Title = “ファイルを開く”;: ダイアログのタイトルを設定します。
openFileDialog.Filter = “テキストファイル(*.txt)|*.txt|すべてのファイル(*.*)|*.*”;
表示するファイルの種類のフィルタを設定します。この例では、テキストファイルとすべてのファイルを表示するように設定しています。
openFileDialog.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
ダイアログを最初に開くディレクトリを「マイドキュメント」に設定します。
openFileDialog.ShowDialog() == DialogResult.OK
ダイアログを表示し、ユーザーが「OK」ボタンをクリックした場合に true を返します。
string filePath = openFileDialog.FileName;
FileName プロパティから、選択されたファイルのパスを取得し、filePath 変数に格納します。
MessageBox.Show(“選択されたファイル: ” + filePath);
メッセージボックスに選択されたファイルパスを表示します。

初期値を設定する

FileName プロパティを使って、OpenFileDialog を開く際に特定のファイルを選択した状態にすることもできます。

private void openButton_Click(object sender, EventArgs e)
{
    OpenFileDialog openFileDialog = new OpenFileDialog();
    openFileDialog.Title = "ファイルを開く";
    openFileDialog.Filter = "テキストファイル(*.txt)|*.txt|すべてのファイル(*.*)|*.*";
    openFileDialog.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

    // 初期ファイルパスを設定
    openFileDialog.FileName = "default.txt";

    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        string filePath = openFileDialog.FileName;
        MessageBox.Show("選択されたファイル: " + filePath);
    }
}

実行例

解説:

openFileDialog.FileName = “default.txt”;

FileName プロパティに default.txt を設定しています。このコードを実行すると、OpenFileDialog が開いた際に、default.txt が選択された状態になります。ファイルが実際に存在しなくても、名前が入力された状態で表示されます。

注意点:

ファイルが存在するかどうかのチェックは、OpenFileDialog 側では行われません。必要に応じて、System.IO.File.Exists() メソッドなどを使って、ファイルが存在するかどうかを確認する必要があります。

まとめ

OpenFileDialog の FileName プロパティは、ファイル選択ダイアログで選択されたファイルパスを取得したり、初期値を設定したりするための重要なプロパティです。この記事で紹介したコード例を参考に、FileName プロパティを効果的に活用し、ユーザーフレンドリーな Windows Forms アプリケーションを作成してください。

Please follow and like us: