SaveFileDialog

[C#] SaveFileDialogで指定されたファイル名を取得する方法

C#でSaveFileDialogを使用して指定されたファイル名を取得するには、まずSaveFileDialogクラスのインスタンスを作成します。

次に、ShowDialogメソッドを呼び出してダイアログを表示し、ユーザーがファイルを選択したかどうかを確認します。

ユーザーがファイルを選択して「保存」をクリックした場合、FileNameプロパティを使用して指定されたファイル名を取得できます。

例えば、if (saveFileDialog.ShowDialog() == DialogResult.OK) { string fileName = saveFileDialog.FileName; }のように記述します。

これにより、ユーザーが選択したファイルのフルパスを取得できます。

目次から探す

SaveFileDialogの設定
ファイル名の取得方法
エラーハンドリング
応用例
まとめ

SaveFileDialogの設定

C#のWindowsフォームアプリケーションでファイルを保存する際に、SaveFileDialogを使用することが一般的です。

このセクションでは、SaveFileDialogの設定方法について詳しく解説します。

フィルターの設定方法

SaveFileDialogでは、ユーザーが選択できるファイルの種類を制限するためにフィルターを設定できます。

フィルターは、表示するファイルの拡張子を指定するために使用されます。

以下のサンプルコードでは、テキストファイルとすべてのファイルを表示するフィルターを設定しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        // フィルターの設定
        saveFileDialog.Filter = "テキストファイル (*.txt)|*.txt|すべてのファイル (*.*)|*.*";
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            // ここでファイルを保存する処理を行う
        }
    }
}

このコードを実行すると、ユーザーはテキストファイルまたはすべてのファイルを選択できるダイアログが表示されます。

初期ディレクトリの設定

SaveFileDialogを表示する際に、初期ディレクトリを指定することができます。

これにより、ユーザーがファイルを保存する際の利便性が向上します。

以下のサンプルコードでは、初期ディレクトリをドキュメントフォルダに設定しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        // 初期ディレクトリの設定
        saveFileDialog.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            // ここでファイルを保存する処理を行う
        }
    }
}

このコードを実行すると、ダイアログが開いたときにドキュメントフォルダが初期表示されます。

デフォルトファイル名の設定

SaveFileDialogでは、ダイアログが表示されたときにデフォルトのファイル名を設定することができます。

これにより、ユーザーがファイル名を入力する手間を減らすことができます。

以下のサンプルコードでは、デフォルトのファイル名を「新しいファイル.txt」に設定しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        // デフォルトファイル名の設定
        saveFileDialog.FileName = "新しいファイル.txt";
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            // ここでファイルを保存する処理を行う
        }
    }
}

このコードを実行すると、ダイアログが開いたときに「新しいファイル.txt」がデフォルトのファイル名として表示されます。

タイトルの設定

SaveFileDialogのタイトルを設定することで、ダイアログの上部に表示されるタイトルをカスタマイズできます。

これにより、ユーザーに対してより明確な指示を提供できます。

以下のサンプルコードでは、タイトルを「ファイルを保存」と設定しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        // タイトルの設定
        saveFileDialog.Title = "ファイルを保存";
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            // ここでファイルを保存する処理を行う
        }
    }
}

このコードを実行すると、ダイアログのタイトルが「ファイルを保存」と表示され、ユーザーに対して明確な指示を与えることができます。

ファイル名の取得方法

SaveFileDialogを使用してファイルを保存する際、ユーザーが選択したファイル名を取得する方法について解説します。

このセクションでは、ShowDialogメソッドの使用、FileNameプロパティの取得、そしてファイル名の検証について詳しく説明します。

ShowDialogメソッドの使用

SaveFileDialogを表示するためには、ShowDialogメソッドを使用します。

このメソッドは、ダイアログを表示し、ユーザーの操作を待機します。

ユーザーがファイル名を選択して「保存」ボタンをクリックした場合、DialogResult.OKが返されます。

以下のサンプルコードでは、ShowDialogメソッドを使用してダイアログを表示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        // ダイアログを表示
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            // ユーザーがファイル名を選択した場合の処理
            string fileName = saveFileDialog.FileName;
            // ここでファイルを保存する処理を行う
        }
    }
}

このコードを実行すると、ユーザーがファイル名を選択するためのダイアログが表示されます。

FileNameプロパティの取得

ユーザーがSaveFileDialogで選択したファイル名は、FileNameプロパティを使用して取得できます。

このプロパティには、選択されたファイルのフルパスが格納されます。

以下のサンプルコードでは、FileNameプロパティを使用してファイル名を取得し、コンソールに表示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            // FileNameプロパティを使用してファイル名を取得
            string fileName = saveFileDialog.FileName;
            
            // ファイル名をコンソールに表示
            Console.WriteLine("選択されたファイル名: " + fileName);
            // ここでファイルを保存する処理を行う
        }
    }
}

このコードを実行すると、選択されたファイル名がコンソールに表示されます。

ファイル名の検証

ファイル名を取得した後は、適切なファイル名であるかどうかを検証することが重要です。

無効な文字が含まれている場合や、既に存在するファイル名の場合は、エラーメッセージを表示することが推奨されます。

以下のサンプルコードでは、ファイル名の検証を行い、無効な場合はメッセージボックスを表示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            
            // ファイル名の検証
            if (string.IsNullOrWhiteSpace(fileName) || fileName.IndexOfAny(System.IO.Path.GetInvalidFileNameChars()) >= 0)
            {
                MessageBox.Show("無効なファイル名です。", "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
            else
            {
                // ここでファイルを保存する処理を行う
            }
        }
    }
}

このコードを実行すると、無効なファイル名が選択された場合にエラーメッセージが表示されます。

これにより、ユーザーが正しいファイル名を選択することを促すことができます。

エラーハンドリング

ファイル保存の際には、さまざまなエラーが発生する可能性があります。

特に、ユーザーが操作をキャンセルした場合や無効なファイル名を指定した場合、またはファイルの保存中に例外が発生することがあります。

このセクションでは、これらのエラーに対するハンドリング方法について解説します。

ユーザーキャンセル時の処理

ユーザーがSaveFileDialogをキャンセルした場合、ShowDialogメソッドはDialogResult.Cancelを返します。

この場合、特別な処理は必要ありませんが、ユーザーに対して何らかのフィードバックを提供することが望ましいです。

以下のサンプルコードでは、ユーザーがキャンセルした場合の処理を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        // ダイアログを表示
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            // ファイルを保存する処理を行う
        }
        else
        {
            // ユーザーがキャンセルした場合の処理
            MessageBox.Show("ファイルの保存がキャンセルされました。", "情報", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
}

このコードを実行すると、ユーザーがキャンセルした場合にメッセージボックスが表示されます。

無効なファイル名の処理

無効なファイル名が指定された場合、適切なエラーメッセージを表示することが重要です。

無効な文字が含まれている場合や、ファイル名が空である場合には、ユーザーに再入力を促すことができます。

以下のサンプルコードでは、無効なファイル名が指定された場合の処理を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            
            // ファイル名の検証
            if (string.IsNullOrWhiteSpace(fileName) || fileName.IndexOfAny(System.IO.Path.GetInvalidFileNameChars()) >= 0)
            {
                MessageBox.Show("無効なファイル名です。再度入力してください。", "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
            else
            {
                // ここでファイルを保存する処理を行う
            }
        }
    }
}

このコードを実行すると、無効なファイル名が指定された場合にエラーメッセージが表示されます。

例外処理の実装

ファイルの保存中に予期しないエラーが発生することがあります。

これを防ぐために、例外処理を実装することが重要です。

try-catchブロックを使用して、ファイル保存処理を囲むことで、エラーが発生した場合に適切な処理を行うことができます。

以下のサンプルコードでは、例外処理を実装しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            
            try
            {
                // ファイルを保存する処理
                System.IO.File.WriteAllText(fileName, "保存する内容");
            }
            catch (Exception ex)
            {
                // 例外が発生した場合の処理
                MessageBox.Show("ファイルの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }
    }
}

このコードを実行すると、ファイル保存中にエラーが発生した場合にエラーメッセージが表示されます。

これにより、ユーザーは問題を認識し、適切な対処を行うことができます。

応用例

SaveFileDialogを使用することで、ユーザーがファイルを保存する際の利便性を向上させることができます。

このセクションでは、具体的な応用例として、ファイルの保存処理の実装、ファイル形式の選択と保存、そしてユーザーインターフェースのカスタマイズについて解説します。

ファイルの保存処理の実装

ファイルの保存処理を実装する際には、ユーザーが選択したファイル名を使用して、実際にデータをファイルに書き込む必要があります。

以下のサンプルコードでは、ユーザーが入力したテキストを指定したファイルに保存する処理を示しています。

partial class MyForm : Form
{
    private TextBox inputTextBox; // ユーザーが入力するテキストボックス
    public MyForm()
    {
        InitializeComponent();
        inputTextBox = new TextBox { Multiline = true, Width = 300, Height = 200 };
        Controls.Add(inputTextBox);
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        saveFileDialog.Filter = "テキストファイル (*.txt)|*.txt|すべてのファイル (*.*)|*.*";
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            
            try
            {
                // ユーザーが入力したテキストをファイルに保存
                System.IO.File.WriteAllText(fileName, inputTextBox.Text);
                MessageBox.Show("ファイルが保存されました。", "成功", MessageBoxButtons.OK, MessageBoxIcon.Information);
            }
            catch (Exception ex)
            {
                MessageBox.Show("ファイルの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }
    }
}

このコードを実行すると、ユーザーがテキストボックスに入力した内容が指定したファイルに保存されます。

ファイル形式の選択と保存

SaveFileDialogを使用して、特定のファイル形式を選択させることができます。

これにより、ユーザーが保存するファイルの形式を明示的に指定することができます。

以下のサンプルコードでは、テキストファイルとCSVファイルの選択肢を提供しています。

partial class MyForm : Form
{
    private TextBox inputTextBox; // ユーザーが入力するテキストボックス
    public MyForm()
    {
        InitializeComponent();
        inputTextBox = new TextBox { Multiline = true, Width = 300, Height = 200 };
        Controls.Add(inputTextBox);
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        saveFileDialog.Filter = "テキストファイル (*.txt)|*.txt|CSVファイル (*.csv)|*.csv|すべてのファイル (*.*)|*.*";
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            
            try
            {
                // ユーザーが入力したテキストをファイルに保存
                System.IO.File.WriteAllText(fileName, inputTextBox.Text);
                MessageBox.Show("ファイルが保存されました。", "成功", MessageBoxButtons.OK, MessageBoxIcon.Information);
            }
            catch (Exception ex)
            {
                MessageBox.Show("ファイルの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }
    }
}

このコードを実行すると、ユーザーはテキストファイルまたはCSVファイルを選択して保存することができます。

ユーザーインターフェースのカスタマイズ

SaveFileDialogのユーザーインターフェースをカスタマイズすることで、より使いやすいアプリケーションを作成することができます。

たとえば、ダイアログのタイトルや初期ディレクトリを設定することで、ユーザーにとっての利便性を向上させることができます。

以下のサンプルコードでは、ダイアログのタイトルと初期ディレクトリを設定しています。

partial class MyForm : Form
{
    private TextBox inputTextBox; // ユーザーが入力するテキストボックス
    public MyForm()
    {
        InitializeComponent();
        inputTextBox = new TextBox { Multiline = true, Width = 300, Height = 200 };
        Controls.Add(inputTextBox);
    }
    private void ShowSaveFileDialog()
    {
        SaveFileDialog saveFileDialog = new SaveFileDialog();
        saveFileDialog.Title = "ファイルを保存";
        saveFileDialog.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        saveFileDialog.Filter = "テキストファイル (*.txt)|*.txt|すべてのファイル (*.*)|*.*";
        
        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            string fileName = saveFileDialog.FileName;
            
            try
            {
                // ユーザーが入力したテキストをファイルに保存
                System.IO.File.WriteAllText(fileName, inputTextBox.Text);
                MessageBox.Show("ファイルが保存されました。", "成功", MessageBoxButtons.OK, MessageBoxIcon.Information);
            }
            catch (Exception ex)
            {
                MessageBox.Show("ファイルの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }
    }
}

このコードを実行すると、ダイアログのタイトルが「ファイルを保存」となり、初期ディレクトリがドキュメントフォルダに設定されます。

これにより、ユーザーはより直感的に操作できるようになります。