実践！Windowsアプリを作る
第1章 WPFアプリケーション

⑤Fromリストボックスのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で[ListBox]を選択
2. 「プロパティ」の"名前"に"FromListBox"と記入
3. 「プロパティ」の"Row"を"1″に、"Column"を"0″に設定
4. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)

⑥Toリストボックスのプロパティを設定していきます。
⑤Fromリストボックスと同様です。

1. 「ドキュメントアウトライン」で[ListBox]を選択
2. 「プロパティ」の"名前"に"ToListBox"と記入
3. 「プロパティ」の"Row"を"1″に、"Column"を"2″に設定
4. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)

⑦Copyボタンのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で[Button]を選択
2. 「プロパティ」の"名前"に"CopyButton"と記入
3. 「プロパティ」の"Row"を"1″に、"Column"を"1″に設定
4. 「プロパティ」の"HorizontalAlignment"と"VerticalAlignment"で"中央揃え"を選択
5. 「プロパティ」の"Margin"の"←"と"→"を"5″に、それ以外を"0″に設定(適当でOK)
6. 「プロパティ」の"Content"を" ⇒ “に変更
7. 「プロパティ」の"IsEnabled"のチェックを外す

リストボックスにファイル名が表示されていない状態では、Copyボタンは意味が無いため、最初は"IsEnabled"を"false"とし、クリックできない様にしています。

⑨Closeボタンのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で[Button]を選択
2. 「プロパティ」の"名前"に"CloseButton"と記入
3. 「プロパティ」の"Row"を"3″に、"Column"を"2″に設定
4. 「プロパティ」の"HorizontalAlignment"で"左揃え"を、"VerticalAlignment"で"中央揃え"を選択
5. 「プロパティ」の"Margin"の"→"と"↑"、"↓"を"5″に、"←"は"0″のままに設定(適当でOK)
6. 「プロパティ」の"Content"を"Close"に変更

①Fromボタンのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で0行0列に配置した[Grid]内の[Button]を選択
2. 「プロパティ」の"名前"に"FromButton"と記入
3. 「プロパティ」の"Row"が"0″、"Column"が"0″であることを確認
4. 「プロパティ」の"HorizontalAlignment"で"左揃え"を、"VerticalAlignment"で"中央揃え"を選択
5. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)
6. 「プロパティ」の"Content"を"From : “に変更

②Fromテキストボックスのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で0行0列に配置した[Grid]内の[TextBox]を選択
2. 「プロパティ」の"名前"に"FromTextBox"と記入
3. 「プロパティ」の"Column"を"1″に変更
4. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)
5. 「プロパティ」の"IsReadOnly"をチェック
6. 「プロパティ」の"Text"は"×"をクリックしてクリア
7. 「プロパティ」の"Width"と"ColumnSpan"は"×"をクリックしてリセット

なおFromテキストボックスで"IsReadOnly"を"false"(編集可)とすると、入力された文字列が正しいディレクトリ名かどうかのチェック等をする必要があり、複雑になるため、今回はFromボタンでの選択のみとし、Fromテキストボックスには選択されたフォルダを表示するだけとします。

③Toボタンのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で0行2列に配置した[Grid]内の[Button]を選択
2. 「プロパティ」の"名前"に"ToButton"と記入
3. 「プロパティ」の"Row"が"0″、"Column"が"0″であることを確認
4. 「プロパティ」の"HorizontalAlignment"で"左揃え"を、"VerticalAlignment"で"中央揃え"を選択
5. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)
6. 「プロパティ」の"Content"を" To : “に変更

④Toテキストボックスのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で0行2列に配置した[Grid]内の[TextBox]を選択
2. 「プロパティ」の"名前"に"ToTextBox"と記入
3. 「プロパティ」の"Column"を"1″に変更
4. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)
5. 「プロパティ」の"IsReadOnly"をチェック
6. 「プロパティ」の"Text"は"×"をクリックしてクリア
7. 「プロパティ」の"Width"と"ColumnSpan"は"×"をクリックしてリセット

なおToテキストボックスで"IsReadOnly"を"false"(編集可)とすると、入力された文字列が正しいディレクトリ名かどうかのチェック等をする必要があり、複雑になるため、今回はToボタンでの選択のみとし、Toテキストボックスには選択されたフォルダを表示するだけとします。

“共通ファイル名 :"ラベルのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で2行2列に配置した[Grid]内の[Label]を選択
2. 「プロパティ」の"HorizontalAlignment"で"左揃え"を、"VerticalAlignment"で"中央揃え"を選択
3. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)
4. 「プロパティ」の"Content"を"共通ファイル名 : “に変更

⑧ファイル名テキストボックスのプロパティを設定していきます。

1. 「ドキュメントアウトライン」で2行2列に配置した[Grid]内の[TextBox]を選択
2. 「プロパティ」の"名前"に"FileNameTextBox"と記入
3. 「プロパティ」の"Column"を"1″に変更
4. 「プロパティ」の"Margin"を全て"5″に設定(適当でOK)
5. 「プロパティ」の"Text"は"×"をクリックしてクリア
6. 「プロパティ」の"Width"と"ColumnSpan"は"×"をクリックしてリセット

ListBoxクラスの"ItemsSource"プロパティにObservableCollection<T>クラスのインスタンスをセットする事で、ObservableCollection<T>のインスタンスに対する項目の追加、削除等の操作を直接リストボックスのリスト表示に反映する事ができます。

型引数Tにstringを指定した場合には、リストボックスにはObservableCollection<string>のインスタンスの要素がそのまま表示されます。

型引数Tにクラスや構造体、タプル等を指定した場合にはリストボックスには、例えばObservableCollection<Tuple<string, string>>のインスタンスの要素のタプルの2つの文字列が並べて表示されます。
型引数に指定したクラスや構造体、タプルの特定のフィールドやプロパティのみを表示したい場合には、XAMLの<ListBox...>タグの子要素として<ListBox.ItemTemplate>タグ内で表示したいフィールドやプロパティを指定します。
例えばタプルの場合には、

<ListBox ...>
    <ListBox.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding Item1}"/>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

のようにします。
上記タプルのようにメンバー名が無い場合には、"Item1″, “Item2″…と云う名前を使用して指定します。

なお、<StackPanel>や<Grid>内に<TextBlock>を複数指定し、リストボックスに複数の項目をリストアップする事も可能です。
更に、<TextBlock>以外にも<Button>や<Image>等を配置する事も可能です。
詳細については検索などして調べて下さい。

今回はObservableCollection<T>の型引数にコピー元のファイル名とコピー先のファイル名をフィールドに持つクラスを指定します。
FromリストボックスとToリストボックスには、其々コピー元のファイル名のプロパティとコピー先のファイル名のプロパティを表示する事とします。

新しいクラスFileNamesとObservableCollection<FileNames>のフィールド/プロパティは以下のようになります。

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace CopyFilesWithSpecifiedName
{
    internal class FileList
    {
        public class FileNames
        {
            public string FromFile { get; set; } = "";
            public string ToFile { get; set; } = "";
        }

        public ObservableCollection<FileNames> FileNameList { get; } = new ObservableCollection<FileNames>();
    }
}

FromリストボックスにFileNamesクラスの"FromFile"プロパティを、ToリストボックスにFileNamesクラスの"ToFile"プロパティを表示するためには、"MainWindow.xaml"ファイルの<ListBox...>タグの部分を以下のように変更します。
なお、GUIでの操作での追加は面倒なので、XAMLファイルを直接編集します。

<ListBox x:Name="FromListBox" d:ItemsSource="{d:SampleData ItemCount=5}" Grid.Row="1" Margin="5,5,5,5">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding FromFile}"/>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>
<ListBox x:Name="ToListBox" Grid.Row="1" Grid.Column="2" Margin="5,5,5,5" d:ItemsSource="{d:SampleData ItemCount=5}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding ToFile}"/>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

最後にMainWindowクラスのフィールドとしてFileListクラスを追加し、コンストラクタ"MainWindw"内でFromリストボックスとToリストボックスの"ItemsSource"にFileListクラスの"FileName"プロパティをセットします。

public partial class MainWindow : Window
{
    private FileList fileList= new FileList();

    public MainWindow()
    {
        InitializeComponent();

        FromListBox.ItemsSource = fileList.FileNameList;
        ToListBox.ItemsSource = fileList.FileNameList;
    }
}

コピー先フォルダを保持するプロパティ"TargetDir"を設定します。

internal class FileList
{
        :
        :
    public string TargetDir { get; set; } = "";
}

コピー元フォルダを保持するプロパティ"SourceDir"を設定します。
なお、例外発生時のエラーメッセージを保持するプロパティ"Message"も設定します。

今回、このフィールドに対するSetterはprivateとして外部からアクセスできないようにしています。
代わりに、コピー元フォルダをセットするためのメソッド"SetSourceDir"を作成します。

“SetSourceDir"メソッド内では、渡されたコピー元フォルダ内の全ファイル名を"FileNameList"にセットします。
因みに、コピー元フォルダ内のファイル名を取得する際に例外が発生する可能性がありますので、処理が成功したかどうかを戻り値として渡します。

internal class FileList
{
    public enum Code
    {
        OK,
        NG,
    }
        :
        :
    public string Message { get; private set; } = "";
    public string SourceDir { get; private set; } = "";
        :
        :
    public Code SetSourceDir(string dir)
    {
        Code result = Code.OK;

        try
        {
            var files = Directory.GetFiles(dir);
            SourceDir = dir;
            FileNameList.Clear();

            foreach (var file in files)
            {
                FileNameList.Add(new FileNames() { FromFile = file });
            }

            this.MakeToFilesList();
        }
        catch (Exception e)
        {
            Message = e.Message;
            result = Code.NG;
        }

        return result;
    }
}

1. Directory.GetFiles(dir): 指定フォルダ内のファイル名を取得、例外が発生する可能性あり
2. FileNameList.Clear(): 前にセットしていたファイル名はリセットする
3. this.MakeToFilesList(): 後に追加するメソッド、コピー先ファイル名を作成
4. Message = e.Message: 例外発生時のエラーメッセージを"Message"プロパティに追加
5. result = Code.NG: 例外発生時にはNGを返す

共通ファイル名を保持するフィールド"baseFileName"を設定します。
プロパティも追加しておきます。

なお、セッターについては、"baseFileName"に値をセットした後"MakeToFileList"メソッドをコールしています。

internal class FileList
{
        :
        :
    private string baseFileName = "new-file-name";
    public string BaseFileName {
        get { return baseFileName; }
        set
        {
            baseFileName = value;
            this.MakeToFilesList();
        }
    }
}

因みにコピー先ファイル名を作成するメソッドthis.MakeToFilesList()は後で追加します。

初期値は"new-file-name"としていますが他の値でも問題ありません。

なお、MainWindowクラスのコンストラクタ中で"FileNameTextBox"中の"Text"に初期値を設定しておきます。

public partial class MainWindow : Window
{
    private FileList fileList= new FileList();

    public MainWindow()
    {
        InitializeComponent();

        FromListBox.ItemsSource = fileList.FileNameList;
        ToListBox.ItemsSource = fileList.FileNameList;
        FileNameTextBox.Text = fileList.BaseFileName;    // 追加
    }
}

“FileNameList"内にセットしたコピー元ファイル名と"baseFileName"を元に、連番を付加してコピー先ファイル名を作成します。
作成したファイル名は、FileNamesクラスの"ToFile"プロパティにセットします。
コピー先フォルダについてはファイル名に含めません。

protected void MakeToFilesList()
{
    int num = 0;
    foreach (var file in FileNameList)
    {
        var ext = Path.GetExtension(file.FromFile);
        var newFileName = $"{baseFileName}{num++:d3}{ext}";
        file.ToFile = newFileName;
    }
}

本アプリケーションの肝となるメソッドです。

“FileNameList"にリストアップされたコピー元ファイル名とコピー先ファイル名、コピー先フォルダ名を使い、ファイルをコピーします。

public Code CopyFiles()
{
    Code result = Code.OK;

    var dir = (TargetDir == "") ? SourceDir : TargetDir;

    foreach (var file in FileNameList)
    {
        var targetFileName = Path.Join(dir, file.ToFile);

        try
        {
            File.Copy(file.FromFile, targetFileName);
        }
        catch (IOException)
        {
            continue;
        }
        catch (Exception e)
        {
            Message = e.Message;
            result = Code.NG;
            break;
        }
    }

    return result;
}

1. dir = (TargetDir == "") ? SourceDir : TargetDir: コピー先フォルダが指定されていない場合にはコピー元フォルダにコピーする
2. targetFileName = Path.Join(dir, file.ToFile): コピー先ファイル名の絶対パスを作成
3. File.Copy(file.FromFile, targetFileName): 実際のファイルコピー、例外が発生する可能性あり

コピー先ファイルが既に存在する等の例外の場合は、そのファイルのコピーはスキップし、次のファイルのコピーを継続します。
それ以外の予期しない例外が発生した場合には、コピーを中断し、負数を返します。

1. 「ソリューションエクスプローラー」の"CopyFilesWithSpecifiedName"を右クリック
2. “NuGetパッケージの管理…"を選択
3. 「NuGetパッケージマネージャー」で「参照」を選択
4. “WindowsAPICodePack-Shell"を選択し、"インストール"をクリック

なお、インストール後やプロジェクトをコンパイルする際に"warning NU1701″の警告が出るかもしれませんが問題ありません。
“WindowsAPICodePack"の作成時の.NETのバージョンが古い事に対する警告です。

CommonOpenFileDialogクラスはダイアログを表示してファイル選択を行うためのクラスです。
ただ、"IsFolderPicker"プロパティを"true"にする事で、ファイルの代わりにフォルダを選択するダイアログとする事ができます。

つまり、Microsoft.Win32.OpenFileDialogクラスより高機能なクラスと言えます。

先ず、CommonOpenFileDialogクラスを使用する場合、usingディレクティブで"Microsoft.WindowsAPICodePack.Dialogs"を指定しておきます。

更に、他のファイル操作用APIにありがちではありますが、CommonOpenFileDialogクラスのインスタンスとして確保したメモリ等のリソースは自動的に解放してくれません。
なので、CommonOpenFileDialogクラスのインスタンスの利用を終えた後に明示的に"Dispose"メソッドを呼び出すか、usingを使用して使用範囲を抜けた際に暗黙的にリソースを解放するようにします。

因みに、今回はCommonOpenFileDialogクラスのインスタンス作成と同時にプロパティをセットするようにしています。

ダイアログの表示は"ShowDialog"メソッドで行います。
戻り値は列挙子CommonFileDialogResultの"OK"か"Cancel"です。
其々、ダイアログでクリックされたボタンに対応しています。

なお、選択されたフォルダ名は"FileName"プロパティに絶対パスとしてセットされています。