第9章　クラスを使いこなそう

この章の目的

この章では、.NET に用意されている便利なクラスを使って、C# の標準機能を 調べながら使う練習 をします。

第 7 章では Employee などのクラスを自分で作成し、第 8 章では DateTime.Now や Math.Max など、クラス名から直接使える機能を学習しました。

実際の開発では、自分でクラスを作るだけでなく、.NET が用意しているクラスを呼び出して使う ことの方が多くなります。次のような処理は、ほぼすべて .NET の標準クラスで実現できます。

文字列の長さを調べる
文字列に特定の文字が含まれるか調べる
文字列をカンマで区切って分割する
小数を四捨五入する
現在の日付を取得して指定形式で表示する
テキストファイルに書き込む
テキストファイルを読み込む

この章では、string の便利な機能、Math クラスの数値計算、DateTime の日付処理、File クラスのファイル操作を扱いながら、名前空間 と using ディレクティブ の役割も整理します。

この章でできるようになること

この章を終えると、次のことができるようになります。

名前空間と using ディレクティブの役割を説明できる
暗黙的 using で省略されている using を理解できる
string の代表的なプロパティ・メソッドを使える(Length、Contains、Substring、Replace、Trim、Split、Join、IsNullOrEmpty など)
Math の代表的な静的メソッドを使える(Round、Ceiling、Floor、Pow など)
DateTime で日付の作成・加算・差の計算ができる
日付を指定した形式の文字列に変換できる
File クラスでテキストファイルを書き込み・読み込みできる
File.Exists でファイルの存在を確認できる
標準クラスを調べながら使う姿勢を身に付ける

本章で使用する環境

項目	内容
開発環境	Visual Studio 2022
プロジェクト種類	コンソールアプリ
対象フレームワーク	.NET 8
ソリューション名	`Chapter09`
プロジェクト名	`Ch09_UsefulClasses`

csproj の Nullable は disable に変更してください

プロジェクト作成後、Ch09_UsefulClasses.csproj を開き、<Nullable>disable</Nullable> に変更してください。

詳しい手順は、第 1 章「1-1 プロジェクトを作成する」を参照してください。

作業前チェック

作業を始める前に、次の内容を確認してください。

クラスを作成し、別ファイルに分けて書ける(第 7 章)
静的メソッド・静的プロパティを使える(第 8 章)
プロパティとメソッドの違いを説明できる
ファイルスコープ namespace を書ける
第 8 章の内容を Git に提出済みである

9-1　名前空間と using

名前空間とは

名前空間(namespace)とは、クラスを分類するための「入れ物」です。 .NET には、数千ものクラスが用意されており、それらは目的別に名前空間で分類されています。

名前空間	内容
`System`	`Console`、`String`、`DateTime`、`Math` など、最も基本的なクラス
`System.IO`	`File`、`Directory` など、ファイル操作のクラス
`System.Collections.Generic`	`List<T>`、`Dictionary<K,V>` などのコレクション
`System.Linq`	LINQ(集合操作)

これまで自作してきたクラスにも namespace を付けてきました(namespace Ch07_Class; など)。名前空間は クラスの「住所」 のようなものと考えると分かりやすいです。

完全修飾名と using ディレクティブ

Console クラスは System 名前空間に含まれています。完全な書き方(完全修飾名)は次のとおりです。

System.Console.WriteLine("こんにちは");

毎回これを書くのは長いので、ファイル先頭に using ディレクティブを書きます。

using System;

Console.WriteLine("こんにちは");

using System; を書くと、「System 名前空間にあるクラスは、名前空間を省略して書ける」という意味になります。

暗黙的 using で省略されている

これまでのサンプルコードでは、using System; を 一度も書いていません。それでも Console.WriteLine や DateTime.Now が使えてきました。

これは、.NET 8 のプロジェクトで 暗黙的 using(<ImplicitUsings>enable</ImplicitUsings>)が有効になっているためです。暗黙的 using が有効だと、次の名前空間が 自動で取り込まれます。

名前空間	含まれる主なクラス
`System`	`Console`、`String`、`DateTime`、`Math`
`System.IO`	`File`、`Directory`
`System.Collections.Generic`	`List<T>`、`Dictionary<K,V>`
`System.Linq`	LINQ 関連
`System.Threading.Tasks`	`Task`

そのため、この研修のコードでは using System; や using System.IO; を書く必要がありません。

補足:暗黙的 using がない場合

古いプロジェクトや、<ImplicitUsings>disable</ImplicitUsings> の場合は、ファイル先頭に using System; などを 明示的に書く必要があります。現場のプロジェクトを読むときは、ファイル先頭の using 一覧を見て「どの名前空間が使われているか」を確認しましょう。

名前空間は住所のようなもの

同じ名前のクラスでも、名前空間が違えば別物として扱えます。

Sales.Employee
  → 営業システム用の Employee クラス

Training.Employee
  → 研修管理用の Employee クラス

どちらも Employee ですが、名前空間が違うので区別できます。大きなシステムでは、機能ごとに名前空間を分けて、クラス名の衝突を防ぎます。

9-2　string の便利な機能

string は文字列を扱う型

これまで、文字列を string 型で扱ってきました。

string employeeName = "山田二郎";

string には、文字列を扱うための 便利なプロパティとメソッド が用意されています。

Length:文字数を取得する

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        string employeeName = "山田二郎";
8

9
        Console.WriteLine($"氏名:{employeeName}");
10
        Console.WriteLine($"文字数:{employeeName.Length}");
11
    }
12
}

実行結果:

氏名:山田二郎
文字数:4

Length は プロパティ なので、() は付けません。

Contains:含まれているか判定する

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        string email = "yamada@example.com";
8

9
        if (email.Contains("@"))
10
        {
11
            Console.WriteLine("@が含まれています。");
12
        }
13
        else
14
        {
15
            Console.WriteLine("@が含まれていません。");
16
        }
17
    }
18
}

実行結果:

@が含まれています。

Contains は、指定した文字列が含まれていれば true、なければ false を返します。

StartsWith / EndsWith:先頭・末尾を判定する

Contains の仲間で、指定した文字列で始まるか / 終わるか を判定します。

string fileName = "report.csv";

Console.WriteLine(fileName.StartsWith("report"));  // 先頭が report か
Console.WriteLine(fileName.EndsWith(".csv"));      // 末尾が .csv か
Console.WriteLine(fileName.EndsWith(".txt"));

実行結果:

True
True
False

ファイルの拡張子チェックや、メールアドレスのドメイン判定などに使います。

Substring:一部を取り出す

string employeeCode = "EMP1001";

string prefix = employeeCode.Substring(0, 3);   // 0番目から3文字
string number = employeeCode.Substring(3);      // 3番目から最後まで

Console.WriteLine($"接頭辞:{prefix}");
Console.WriteLine($"番号:{number}");

実行結果:

接頭辞:EMP
番号:1001

E M P 1 0 0 1
0 1 2 3 4 5 6   ← インデックス

Substring(開始位置, 文字数) または Substring(開始位置) のように使います。

注意:範囲外を指定するとエラー

文字列の長さを超える位置を指定すると、実行時にエラー(ArgumentOutOfRangeException)になります。 code.Substring(3, 4) のように、文字列の長さに対して十分かどうか確認しましょう。

Replace:置き換える

string message = "C#を勉強しています。";
string replaced = message.Replace("勉強", "学習");

Console.WriteLine(message);
Console.WriteLine(replaced);

実行結果:

C#を勉強しています。
C#を学習しています。

Replace は、元の文字列を変更せず、置き換え後の新しい文字列を返します。 message 自身は変わらない点に注意してください。

ToUpper / ToLower:大文字・小文字に揃える

string command = "Add";

Console.WriteLine(command.ToUpper());
Console.WriteLine(command.ToLower());

実行結果:

ADD
add

入力されたコマンドを小文字に統一してから判定する、といった用途に便利です。

string input = Console.ReadLine();
string normalized = input.ToLower();

Trim:前後の空白を取り除く

string input = "  yamada  ";
string trimmed = input.Trim();

Console.WriteLine($"[{input}]");
Console.WriteLine($"[{trimmed}]");

実行結果:

[  yamada  ]
[yamada]

ユーザー入力の前後に余計な空白が入ってしまうケースに有効です。

IsNullOrEmpty / IsNullOrWhiteSpace:空かどうかを判定する

入力チェックでは「文字列が空かどうか」を頻繁に判定します。 string.IsNullOrEmpty は null または空文字列("") のときに true を返します。

string input1 = "";
string input2 = "山田";

Console.WriteLine(string.IsNullOrEmpty(input1));  // True
Console.WriteLine(string.IsNullOrEmpty(input2));  // False

IsNullOrWhiteSpace は、それに加えて 空白だけの文字列(スペースやタブ)も true とみなします。

string input3 = "   ";   // 空白だけ

Console.WriteLine(string.IsNullOrEmpty(input3));       // False(空白も文字とみなす)
Console.WriteLine(string.IsNullOrWhiteSpace(input3));  // True

補足:string クラスから直接呼ぶ静的メソッド

これらは input.IsNullOrEmpty() ではなく、string.IsNullOrEmpty(input) のように string クラス名から呼び出す静的メソッド(第 8 章)です。引数が null でも安全に判定できるので、入力チェックの定番として使われます。

利用例:名前が未入力なら警告する。

string name = Console.ReadLine();

if (string.IsNullOrWhiteSpace(name))
{
    Console.WriteLine("名前を入力してください。");
}

Split:区切り文字で分割する

1 つの文字列を、区切り文字で 複数の文字列(配列)に分割 します。 CSV(カンマ区切り)のデータを 1 行ずつ読むときなどに使う、とても出番の多いメソッドです。

string csvLine = "1001,山田,二郎,総務";

string[] columns = csvLine.Split(',');

Console.WriteLine(columns[0]);   // 1001
Console.WriteLine(columns[1]);   // 山田
Console.WriteLine(columns[2]);   // 二郎
Console.WriteLine(columns[3]);   // 総務
Console.WriteLine($"列数:{columns.Length}");

実行結果:

1001
山田
二郎
総務
列数:4

Split(',') は string[](文字列の配列) を返します。第 6 章で学んだ配列の知識がそのまま使えます。

補足:分割した値は文字列のまま

columns[0] は "1001" という 文字列 です。数値として計算に使いたい場合は、int.Parse(columns[0]) や int.TryParse(第 15 章)で数値に変換します。

Join:区切り文字でつなぐ

Split の逆で、配列やリストを区切り文字でつないで 1 つの文字列にします。 CSV の 1 行を組み立てて書き出すときなどに使います。

string[] columns = { "1001", "山田", "二郎", "総務" };

string csvLine = string.Join(",", columns);

Console.WriteLine(csvLine);

実行結果:

1001,山田,二郎,総務

string.Join(区切り文字, 配列) のように、string クラス名から呼び出す静的メソッドです。

よく使う string のメンバー一覧

メンバー	種類	内容	返す型
`Length`	プロパティ	文字数	`int`
`Contains(s)`	メソッド	`s` を含むか	`bool`
`StartsWith(s)`	メソッド	`s` で始まるか	`bool`
`EndsWith(s)`	メソッド	`s` で終わるか	`bool`
`Substring(start, length)`	メソッド	一部を取り出す	`string`
`Replace(old, new)`	メソッド	置き換える	`string`
`ToUpper()` / `ToLower()`	メソッド	大文字/小文字に変換	`string`
`Trim()`	メソッド	前後の空白を取り除く	`string`
`Split(c)`	メソッド	区切り文字で分割	`string[]`
`string.Join(c, 配列)`	静的メソッド	区切り文字でつなぐ	`string`
`string.IsNullOrEmpty(s)`	静的メソッド	`null` または空文字列か	`bool`
`string.IsNullOrWhiteSpace(s)`	静的メソッド	`null`・空・空白だけか	`bool`

文字列を加工する Substring・Replace・ToUpper・ToLower・Trim は、新しい文字列を返し、元の文字列は変更しません。 Contains・StartsWith・EndsWith・IsNullOrEmpty は bool(真偽値)、Split は配列を返します。 string.Join と string.IsNullOrEmpty 系は、string クラス名から呼び出す 静的メソッド(第 8 章)である点に注意してください。

9-3　Math の便利な機能

Math は静的メソッドの集まり

Math クラスには、数値計算用の 静的メソッド が用意されています。第 8 章では Math.Max・Math.Min を扱いました。この章では、もう少し便利なメソッドを見ていきます。

Round:四捨五入する

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        double average = 82.6666667;
8

9
        double rounded = Math.Round(average, 1);
10

11
        Console.WriteLine($"元の値:{average}");
12
        Console.WriteLine($"丸めた値:{rounded}");
13
    }
14
}

実行結果:

元の値:82.6666667
丸めた値:82.7

Math.Round(値, 桁数) で、指定した小数位で四捨五入できます。

Ceiling / Floor:切り上げ・切り捨て

double value = 12.3;

Console.WriteLine(Math.Ceiling(value));   // 切り上げ → 13
Console.WriteLine(Math.Floor(value));     // 切り捨て → 12

メソッド	意味
`Math.Round(値, 桁数)`	四捨五入
`Math.Ceiling(値)`	切り上げ(整数値へ)
`Math.Floor(値)`	切り捨て(整数値へ)

Pow:べき乗

double result = Math.Pow(2, 3);   // 2 の 3 乗

Console.WriteLine(result);

実行結果:

Math.Pow(底, 指数) で、底を指数回掛け合わせた値を返します(戻り値は double)。

利用例:平均点を丸めて表示する

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        int[] scores = { 80, 75, 90, 68, 85 };
8

9
        int total = 0;
10
        foreach (int score in scores)
11
        {
12
            total += score;
13
        }
14

15
        double average = (double)total / scores.Length;
16
        double rounded = Math.Round(average, 1);
17

18
        Console.WriteLine($"平均点:{rounded}");
19
    }
20
}

実行結果:

平均点:79.6

9-4　DateTime の便利な機能

日付の作成

特定の日付を表すオブジェクトは、new DateTime(年, 月, 日) で作成します。

DateTime trainingStartDate = new DateTime(2026, 5, 18);

Console.WriteLine(trainingStartDate);

実行結果:

2026/05/18 0:00:00

時刻まで指定したい場合は new DateTime(2026, 5, 18, 9, 30, 0) のように書きます。

AddDays:日付を加算する

DateTime startDate = new DateTime(2026, 5, 18);
DateTime endDate = startDate.AddDays(27);

Console.WriteLine($"開始日:{startDate}");
Console.WriteLine($"終了予定日:{endDate}");

実行結果:

開始日:2026/05/18 0:00:00
終了予定日:2026/06/14 0:00:00

AddDays と同じように AddMonths・AddYears・AddHours などもあります。

日付の差を求める

2 つの日付の差は、引き算で求められます。戻り値は TimeSpan 型(時間の長さを表す型)です。

DateTime startDate = new DateTime(2026, 5, 18);
DateTime endDate = new DateTime(2026, 6, 14);

TimeSpan period = endDate - startDate;

Console.WriteLine($"日数:{period.Days}日");

実行結果:

日数:27日

TimeSpan の Days プロパティで日数を取得できます。

ToString:表示形式を指定する

DateTime の ToString(書式) で、好きな形式の文字列に変換できます。

DateTime date = new DateTime(2026, 5, 18, 9, 30, 0);

Console.WriteLine(date.ToString("yyyy/MM/dd"));
Console.WriteLine(date.ToString("yyyy年MM月dd日"));
Console.WriteLine(date.ToString("yyyy/MM/dd HH:mm"));

実行結果:

2026/05/18
2026年05月18日
2026/05/18 09:30

主な日付書式

書式	表示例	意味
`yyyy`	`2026`	西暦 4 桁
`MM`	`05`	月 2 桁(0 埋め)
`M`	`5`	月(0 埋めなし)
`dd`	`18`	日 2 桁(0 埋め)
`HH`	`09`	時 2 桁(24 時制)
`mm`	`30`	分 2 桁
`ss`	`00`	秒 2 桁

業務アプリでは、画面表示用・ファイル名用・ログ出力用など、用途に応じて書式を使い分けます。

利用例:ファイル名に日付を入れる

DateTime today = DateTime.Today;
string fileName = $"sales_{today.ToString("yyyyMMdd")}.txt";

Console.WriteLine(fileName);

実行結果(例):

sales_20260518.txt

yyyyMMdd のように区切り文字なしの書式を使うと、ファイル名に使いやすい文字列が作れます。

9-5　File クラスでファイル操作

File クラスの基本

File クラスは、テキストファイルの読み書きに使う静的クラスです。 System.IO 名前空間に含まれていますが、暗黙的 using で省略済み なので、そのまま File.〇〇 の形で使えます。

テキストファイルに書き込む

社員名の一覧をテキストファイルに書き込みます。

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        string[] employeeNames =
8
        {
9
            "山田二郎",
10
            "佐藤昭夫",
11
            "山口洋子"
12
        };
13

14
        File.WriteAllLines("employee_names.txt", employeeNames);
15

16
        Console.WriteLine("ファイルを書き込みました。");
17
    }
18
}

実行結果:

ファイルを書き込みました。

employee_names.txt というファイルが作成されます。

補足:ファイルの作成場所

ファイル名だけを指定した場合、ファイルはプログラムの 実行フォルダ に作成されます。 Visual Studio から実行した場合、プロジェクトフォルダではなく bin\Debug\net8.0\ フォルダに作られます。ファイルが見つからないときは、このフォルダを探してみてください。

テキストファイルを読み込む

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        string[] lines = File.ReadAllLines("employee_names.txt");
8

9
        foreach (string line in lines)
10
        {
11
            Console.WriteLine(line);
12
        }
13
    }
14
}

実行結果:

山田二郎
佐藤昭夫
山口洋子

File.ReadAllLines は、ファイルの全行を string[] として返します。

File.Exists でファイルの存在を確認する

ファイルが存在しない状態で ReadAllLines を実行するとエラーになります。そこで、File.Exists で先に存在を確認します。

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        string filePath = "employee_names.txt";
8

9
        if (File.Exists(filePath))
10
        {
11
            string[] lines = File.ReadAllLines(filePath);
12
            foreach (string line in lines)
13
            {
14
                Console.WriteLine(line);
15
            }
16
        }
17
        else
18
        {
19
            Console.WriteLine("ファイルが見つかりません。");
20
        }
21
    }
22
}

File の主なメソッド

メソッド	内容
`File.WriteAllLines(path, lines)`	配列をファイルに書き込む(上書き)
`File.WriteAllText(path, text)`	文字列をファイルに書き込む(上書き)
`File.ReadAllLines(path)`	ファイルを `string[]` として読み込む
`File.ReadAllText(path)`	ファイルを 1 つの文字列として読み込む
`File.AppendAllText(path, text)`	ファイルに追記する
`File.Exists(path)`	ファイルが存在するか調べる

利用例:ログファイルに追記する

1
namespace Ch09_UsefulClasses;
2

3
internal class Program
4
{
5
    static void Main(string[] args)
6
    {
7
        string timeStamp = DateTime.Now.ToString("yyyy/MM/dd HH:mm:ss");
8
        string logText = $"{timeStamp} アプリを実行しました。";
9

10
        File.AppendAllText("app.log", logText + Environment.NewLine);
11

12
        Console.WriteLine("ログを追記しました。");
13
    }
14
}

Environment.NewLine は、環境に応じた改行コードを表します(Windows なら \r\n)。

実行結果:

ログを追記しました。

app.log の内容(2 回実行した場合):

2026/05/18 09:30:00 アプリを実行しました。
2026/05/18 09:35:12 アプリを実行しました。

ファイル操作で起こりやすい問題

ファイルが存在しない
保存先フォルダが存在しない
同じ名前のファイルを上書きしてしまう
他のアプリがファイルを開いている

これらに本格的に対処するには 例外処理 が必要です。例外処理は後の章で扱います。

よくあるつまずき

つまずき	原因	対応
`using` の意味が分からない	名前空間との関係が曖昧	「名前空間を省略して書ける」と覚える
`using System;` を書かないと動かないと思う	暗黙的 using の存在を知らない	.NET 8 の暗黙的 using で省略されている
`Length` に `()` を付けてしまう	プロパティとメソッドの混同	`Length` はプロパティ
`Replace` で元の変数が変わらない	戻り値を受け取っていない	`s = s.Replace(...);` のように代入する
`Substring` で実行時エラー	文字列の長さを超える位置を指定している	範囲を確認する
`Split` の結果を数値として計算できない	分割後も文字列のまま	`int.Parse` / `int.TryParse` で変換する
`IsNullOrEmpty` を `s.IsNullOrEmpty()` と書く	静的メソッドをインスタンスから呼んでいる	`string.IsNullOrEmpty(s)` のようにクラス名から呼ぶ
`DateTime.Now()` と書いてしまう	プロパティに `()` を付けている	`Now` はプロパティ
日付の書式が思った通りにならない	書式記号を間違えている	`yyyy`・`MM`・`dd` の大文字小文字に注意
ファイルが見つからない	実行フォルダを誤解している	`bin\Debug\net8.0\` を確認
`File.ReadAllLines` でエラー	ファイルが存在しない	`File.Exists` で先に確認
`Math.Round` の戻り値の桁数が思った通りでない	第 2 引数を指定していない	`Math.Round(値, 1)` のように桁数を指定

学んだことチェック

ペア確認

研修の進め方によっては、隣の人またはチーム内で説明確認を行います。

次の内容を、自分の言葉で説明してください。

名前空間は何のためにありますか。
using System; を書かなくても Console.WriteLine が使えるのはなぜですか。
Length と Contains() の書き方の違いは何ですか。
Math.Round(82.666, 1) は何を返しますか。
DateTime.Now と DateTime.Today の違いは何ですか。
File.WriteAllLines と File.ReadAllLines は、それぞれ何をするメソッドですか。
ファイルを読み込む前に File.Exists を使う理由は何ですか。

説明するときは、完全な答えでなくても構いません。自分の言葉で説明しようとすることが大切です。

演習課題

この章の演習課題に取り組みます。

本章では タイマー方式 を試験導入します。次の 3 段階で進めてください。

段階	時間	内容
① 準備	10 分(目安)	上の「ペア確認」と、これから取り組む課題(仕様)の読み込み。ペアや講師に質問してよい
② ソロ作業	30 分(タイマーで計測)	一人で課題に取り組む。タイマーが鳴ったら、完成・未完成にかかわらず作業を止めて提出する
③ チーム時間	講師が指定する発表開始時刻まで	チーム内でコードレビューを行い、発表者を決める。実装の続行も可。時間配分はチームで管理する

第 9 章は .NET 標準ライブラリの使い方 が中心で、新しいロジックは少なめですが、課題数が多く File 入出力でファイル作成も伴います。ソロ作業は 30 分 をとっています。準備フェーズの終わりに講師が号令をかけ、そこからタイマーを開始します。 評価対象はタイマー時点で提出されたコードです(タイマー後に書き足した分は評価には含まれません)。 発表開始時刻は厳守 です。チーム時間中も、その時刻が来たら全員手を止めて発表に移ります。

演習の進め方の詳細は、付録A「演習の進め方」 を参照してください。

この章の演習の進め方

課題はソリューション Kadai09 の中に作成してください。 課題ごとに別のプロジェクトを作成 し、指定されたプロジェクト名を使います。

課題	必須/発展	プロジェクト名	作成する主なファイル
課題 9-1	必須	`Kd09_01_StringPractice`	`Program.cs`
課題 9-2	必須	`Kd09_02_DateTimeFormat`	`Program.cs`
課題 9-3	必須	`Kd09_03_FileReadWrite`	`Program.cs`
課題 9-4	発展	`Kd09_04_CommandJudge`	`Program.cs`
課題 9-5	発展	`Kd09_05_TrainingSchedule`	`Program.cs`
課題 9-6	発展	`Kd09_06_AppLog`	`Program.cs`

フォルダ構成は次のようになります。

Kadai09/                          ← 課題用ソリューションフォルダ
  Kadai09.sln
  Kd09_01_StringPractice/
  Kd09_02_DateTimeFormat/
  Kd09_03_FileReadWrite/
  Kd09_04_CommandJudge/
  Kd09_05_TrainingSchedule/
  Kd09_06_AppLog/

補足:ソリューションに複数のプロジェクトを追加する方法

最初の課題で Kadai09 ソリューションと Kd09_01_StringPractice プロジェクトを同時に作成します。

2 つ目以降の課題は、ソリューションエクスプローラーで Kadai09 を右クリックし、追加 → 新しいプロジェクト から追加します。

演習の共通ルール

以下は、本章のすべての課題に共通する作業です。各課題の本文には繰り返し書きません。

作業	内容	参照
プロジェクト作成時の設定	「最上位レベルのステートメントを使用しない」にチェック	第 1 章 1-1
csproj の編集	`<Nullable>disable</Nullable>` に変更	第 1 章 1-1
`namespace` の書き方	ファイルスコープ形式(`namespace XXX;`)で書く	第 7 章冒頭
ファイルを保存して実行	`Ctrl + S` で保存 → `F5` で実行	第 1 章 1-2

特に 2 つ目以降のプロジェクト(Kd09_02_DateTimeFormat など)も、新規追加するたびに csproj の Nullable を disable に変更する 必要があります。

Program.cs を自動生成すると、ブロック形式の namespace プロジェクト名 { ... } で作られます(例:課題 9-1 なら namespace Kd09_01_StringPractice { ... })。本章でもファイルスコープ形式に統一するため、生成後に namespace Kd09_01_StringPractice; のように ; 形式に書き換えてください。

提出ルール(タイマー方式)

準備フェーズの後、講師の号令で 30 分のタイマー をスタートします

タイマーが鳴ったら、完成・未完成にかかわらず手を止め、その場で git add → git commit → git push を行います

これがこの演習の 唯一の提出 です。タイマー後も実装を続けて構いませんが、書き足した分は評価対象には含まれません

コミットメッセージの形式:
Chapter09 タイマー提出: <どの課題まで完成> / <詰まったポイント>
例:

Chapter09 タイマー提出: 9-1〜9-2完成、9-3は途中 / File.WriteAllLines の使い方で詰まった

Chapter09 タイマー提出: 9-1〜9-3完成、発展未着手 / 特になし

Chapter09 タイマー提出: 9-1完成、9-2の途中 / DateTime の書式指定子が思い出せない

「どこまでできたか」「詰まったポイント」は短くて構いません。順調なときも「特になし」と明示 してください(順調さの証拠になります)。

提出方法:Git が使えないときはサーバへコピー

Git の状態によっては、講師から「今回は push ではなくサーバへのフォルダコピーで提出」と指示が出ることがあります。その場合は、push の代わりに Kadai09 フォルダをサーバの所定の場所へコピーして提出してください(コピー手順は別途案内済みのとおり)。

このとき コミットメッセージが残せない ため、代わりに 提出メモ.txt というテキストファイルを提出先に作成します。コピーが終わってから、次の手順で作成してください。

Kadai09 フォルダをコピーした、サーバ上の自分の名前のフォルダをエクスプローラーで開く

何もないところで右クリック → 新規作成 → テキストドキュメントを選ぶ

ファイル名を 提出メモ.txt に変更する

ダブルクリックで開き、次の内容を書いて保存する
どこまで完成: 9-1〜9-3完成、発展未着手
詰まったポイント: 特になし
書く内容は、コミットメッセージに書くはずだった「どこまで完成したか」「詰まったポイント」と同じです。順調なときも「詰まったポイント: 特になし」と明示 してください。

タイマー後のチーム時間の使い方

タイマー後、講師が指定する 発表開始時刻 までがチーム時間です。チーム内で次の 3 つを自由に管理してください。

コードレビュー:他のメンバーの commit を読んで、気づいたことを共有する

発表者の選出:発表開始時刻に、チームから 1 人が要点を発表できるよう、誰が話すかを決めておく

実装の続行(任意):途中だった課題を続けても構いません(提出後の追加分は評価対象外ですが、理解を深める意義はあります)

どの順番で進めるか、何分ずつ使うかはチームの判断です。ただし 発表開始時刻は厳守 です。その時刻までにレビューと発表者選出を必ず終わらせてください。

必須課題

まずは、全員が必須課題に取り組んでください。

課題 9-1　文字列を分解・判定する

社員コードとメールアドレスから情報を取り出すプログラムを作成してください。

次の値を変数に代入して使います。

string employeeCode = "EMP1001";
string email = "yamada@example.com";

次の内容を表示してください。

社員コードの先頭 3 文字(接頭辞)
社員コードの 4 文字目以降(番号)
メールアドレスの文字数
メールアドレスに @ が含まれているかどうか(true/false)

実行結果例:

接頭辞:EMP
番号:1001
メール文字数:18
@含む:True

条件:

Substring、Length、Contains を使う
文字列補間 $"..." で表示する

課題 9-2　今日の日付を表示する

DateTime.Today を使って、今日の日付を 3 つの形式で表示してください。

実行結果例(2026/05/18 に実行した場合):

2026/05/18
2026年05月18日
20260518

条件:

DateTime.Today を使う
ToString("yyyy/MM/dd") を使う
ToString("yyyy年MM月dd日") を使う
ToString("yyyyMMdd") を使う

課題 9-3　社員名一覧をファイルに書き出して読み戻す

社員名 3 名分を employee_names.txt に書き込み、書き込んだファイルを読み込んで表示してください。

書き込む内容:

山田二郎
佐藤昭夫
山口洋子

実行結果例:

ファイルを書き込みました。
--- 読み込み結果 ---
山田二郎
佐藤昭夫
山口洋子

条件:

string[] を使う
File.WriteAllLines で書き込む
File.Exists でファイルの存在を確認する
File.ReadAllLines で読み込み、foreach で表示する

発展課題

必須課題が終わった人は、発展課題に取り組んでください。発展課題からは、仕様だけが提示されます。実装方法は自分で考えてください。

課題 9-4　コマンド判定

ユーザーから入力されたコマンドを 小文字に統一してから 判定するプログラムを作成してください。

仕様

Console.ReadLine でコマンドを 1 行受け取る
入力を Trim で前後の空白を取り除き、ToLower で小文字に変換する
次のいずれかに応じて表示する(switch 文を使う)

コマンド(小文字後)	表示
`add`	登録処理を行います
`list`	一覧表示を行います
`exit`	終了します
それ以外	不明なコマンドです

実行例:

コマンドを入力してください:  ADD
登録処理を行います

課題 9-5　研修スケジュールを作成する

以下の仕様で、研修日程を計算して表示するプログラムを作成してください。

仕様

研修開始日:new DateTime(2026, 5, 18)
研修期間:27 日後が終了予定日
表示する内容:
- 開始日(yyyy/MM/dd)
- 終了予定日(yyyy/MM/dd)
- 研修日数(終了予定日 − 開始日 = 何日)

実行結果例:

開始日:2026/05/18
終了予定日:2026/06/14
研修日数:27日

条件:

AddDays を使う
TimeSpan の Days プロパティを使う
ToString("yyyy/MM/dd") を使う

課題 9-6　アプリ実行ログ

プログラム実行時の日時を app.log に追記するプログラムを作成してください。複数回実行すると、行が増えていくようにします。

仕様

現在日時(DateTime.Now)を yyyy/MM/dd HH:mm:ss 形式で取得する
"{日時} アプリを実行しました。" という形式のログを app.log に追記する
改行には Environment.NewLine を使う
書き込み後、File.ReadAllLines で全行読み込み、行数を表示する

実行結果例(3 回目の実行時):

ログを追記しました。
現在のログ行数:3行

app.log の内容例:

2026/05/18 09:30:00 アプリを実行しました。
2026/05/18 09:35:12 アプリを実行しました。
2026/05/18 09:40:45 アプリを実行しました。

提出前チェックリスト

Git への提出

タイマーが鳴ったら、第 9 章の課題プロジェクト群(Kadai09 ソリューション)をその場で Git に提出します。

git status
git add .
git commit -m "Chapter09 タイマー提出: <どこまで完成> / <詰まったポイント>"
git push

実行例:

git commit -m "Chapter09 タイマー提出: 9-1〜9-2完成、9-3は途中 / File.WriteAllLines の使い方で詰まった"

Git の詳しい操作は、付録 C「Git のインストールと提出ルール」 を参照してください。

コミットメッセージの形式は、本章冒頭「演習課題 > 提出ルール(タイマー方式)」を参照してください。

サーバへのコピーで提出する場合

講師から指示があった場合は、push の代わりに Kadai09 フォルダをサーバへコピーして提出します。コピー後、提出先(サーバ上の自分の名前のフォルダ)をエクスプローラーで開き、右クリック → 新規作成 → テキストドキュメントで 提出メモ.txt を作って「どこまで完成」「詰まったポイント」を書いてください。詳しくは本章冒頭「演習課題 > 提出方法:Git が使えないときはサーバへコピー」を参照してください。

補足:出力ファイルの扱い

ファイル操作の課題では、作成された .txt や .log ファイルが bin\Debug\net8.0\ フォルダに残ります。これらを Git に含めるかどうかは、研修の指示に従ってください。通常、bin/ フォルダは .gitignore で除外されるため、自動的に提出対象外になることが多いです。

この章のまとめ

この章では、.NET が用意している便利なクラスを使いました。主な内容は次のとおりです。

名前空間はクラスを分類する入れ物、using で名前空間の指定を省略できる
暗黙的 using により、System や System.IO などは自動で取り込まれている
string には Length・Contains・Substring・Replace・ToLower・Trim などの便利な機能がある
string の Split(分割)・Join(連結)・IsNullOrEmpty/IsNullOrWhiteSpace(空判定)は、CSV 処理や入力チェックでよく使う
Math には Round・Ceiling・Floor・Pow などの数値計算メソッドがある
DateTime は日付の作成・加算・差分計算・形式変換ができる
TimeSpan は時間の長さを表す型で、日付の引き算の結果として得られる
File クラスで、テキストファイルの書き込み・読み込み・追記・存在確認ができる
標準クラスは「自分で作らずに調べて使う」ことが基本

次章の予告

次章では、クラスについてさらに掘り下げます。

メソッドのオーバーロード(同名メソッドの複数定義)、省略可能な引数、コンストラクター、プロパティの実装方法などを学び、クラスをより実践的に使えるようにしていきます。

第 7 章から第 9 章で身に付けた基礎を土台に、次章ではクラスの設計力を伸ばしていきます。

第9章 クラスを使いこなそう

この章の目的

この章でできるようになること

本章で使用する環境

作業前チェック

9-1 名前空間と using

名前空間とは

完全修飾名と using ディレクティブ

暗黙的 using で省略されている

名前空間は住所のようなもの

9-2 string の便利な機能

string は文字列を扱う型

Length:文字数を取得する

Contains:含まれているか判定する

StartsWith / EndsWith:先頭・末尾を判定する

Substring:一部を取り出す

Replace:置き換える

ToUpper / ToLower:大文字・小文字に揃える

Trim:前後の空白を取り除く

IsNullOrEmpty / IsNullOrWhiteSpace:空かどうかを判定する

Split:区切り文字で分割する

Join:区切り文字でつなぐ

よく使う string のメンバー一覧

9-3 Math の便利な機能

Math は静的メソッドの集まり

Round:四捨五入する

Ceiling / Floor:切り上げ・切り捨て

Pow:べき乗

利用例:平均点を丸めて表示する

9-4 DateTime の便利な機能

日付の作成

AddDays:日付を加算する

日付の差を求める

ToString:表示形式を指定する

主な日付書式

利用例:ファイル名に日付を入れる

9-5 File クラスでファイル操作

File クラスの基本

テキストファイルに書き込む

テキストファイルを読み込む

File.Exists でファイルの存在を確認する

File の主なメソッド

利用例:ログファイルに追記する

ファイル操作で起こりやすい問題

よくあるつまずき

学んだことチェック

ペア確認

演習課題

この章の演習の進め方

演習の共通ルール

必須課題

課題 9-1 文字列を分解・判定する

課題 9-2 今日の日付を表示する

課題 9-3 社員名一覧をファイルに書き出して読み戻す

発展課題

課題 9-4 コマンド判定

課題 9-5 研修スケジュールを作成する

課題 9-6 アプリ実行ログ

提出前チェックリスト

Git への提出

この章のまとめ

次章の予告

第9章　クラスを使いこなそう

9-1　名前空間と using

9-2　string の便利な機能

9-3　Math の便利な機能

9-4　DateTime の便利な機能

9-5　File クラスでファイル操作

課題 9-1　文字列を分解・判定する

課題 9-2　今日の日付を表示する

課題 9-3　社員名一覧をファイルに書き出して読み戻す

課題 9-4　コマンド判定

課題 9-5　研修スケジュールを作成する

課題 9-6　アプリ実行ログ