Visual Studio Code を使用して .NET クラスライブラリをテストする - .NET

このチュートリアルでは、テストプロジェクトをソリューションに追加して、単体テストを自動化する方法について説明します。

必須コンポーネント

このチュートリアルでは、「Visual Studio Code を使用して .NET クラスライブラリを作成する」で作成するソリューションを使用します。

単体テストプロジェクトを作成する

単体テストでは、開発および公開時に自動化されたソフトウェアテストが提供されます。このチュートリアルで使用するテストフレームワークは MSTest です。 MSTest は、選択できる 3 つのテストフレームワークのうちの 1 つです。これ以外は、xUnit と nUnit です。

Visual Studio Code を開始します。
「Visual Studio Code を使用して .NET クラスライブラリを作成する」で作成した ClassLibraryProjects ソリューションを開きます。
「StringLibraryTest」という名前の単体テストプロジェクトを作成します。
```
dotnet new mstest -o StringLibraryTest
```
プロジェクトテンプレートでは、次のコードを使用して UnitTest1.cs ファイルを作成します。
```
namespace StringLibraryTest;

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestMethod1()
    {
    }
}
```
単体テストのテンプレートで作成されたソースコードにより、次の処理が行われます。
- TestClassAttribute 属性が UnitTest1 クラスに適用されます。
- TestMethodAttribute 属性を適用して TestMethod1 を定義します。
- 単体テストで使用される型が含まれた Microsoft.VisualStudio.TestTools.UnitTesting 名前空間がインポートされます。名前空間は GlobalUsings.cs の global using ディレクティブを介してインポートされます。
[TestClass] でタグ付けされたテストクラスの [TestMethod] でタグ付けされた各テストメソッドが、単体テスト実行時に自動実行されます。
次のように、テストプロジェクトをソリューションに追加します。
```
dotnet sln add StringLibraryTest/StringLibraryTest.csproj
```

プロジェクト参照を追加する

テストプロジェクトが StringLibrary クラスと連動するように、StringLibraryTest プロジェクトに StringLibrary プロジェクトへの参照を追加します。

次のコマンドを実行します。

dotnet add StringLibraryTest/StringLibraryTest.csproj reference StringLibrary/StringLibrary.csproj

単体テストメソッドの追加と実行

Visual Studio で単体テストを実行すると、TestClassAttribute 属性でマークされたクラス内で、TestMethodAttribute 属性でマークされた各メソッドが実行されます。テストメソッドは、最初の失敗が検出されたとき、またはそのメソッドに含まれているすべてのテストが成功したときに終了します。

一般的なテストでは、Assert クラスのメンバーが呼び出されます。多くのアサートメソッドは最低 2 つのパラメーターを含んでいます。1 つは予期されるテスト結果、もう 1 つは実際のテスト結果です。次の表に、Assert クラスの頻繁に呼び出されるメソッドをいくつか示します。

Assert メソッド	関数
`Assert.AreEqual`	2 つの値または 2 つのオブジェクトが等しいことを確認します。値またはオブジェクトが等しくない場合、アサートは失敗します。
`Assert.AreSame`	2 つのオブジェクト変数が同じオブジェクトを参照していることを確認します。変数が別々のオブジェクトを参照している場合、アサートは失敗します。
`Assert.IsFalse`	条件が `false` であることを確認します。条件が `true` の場合、アサートは失敗します。
`Assert.IsNotNull`	オブジェクトが `null` でないことを確認します。オブジェクトが `null` である場合、アサートは失敗します。

また、テストメソッドで Assert.ThrowsException メソッドを使用して、スローすることが期待される例外の種類を示すこともできます。指定した例外がスローされない場合、テストは失敗します。

StringLibrary.StartsWithUpper メソッドのテストでは、大文字で始まる文字列を多く用意します。これらの場合ではメソッドが true を返すと予測されるので、Assert.IsTrue メソッドを呼び出すことができます。同様に、大文字以外で始まる文字列を多く用意します。これらの場合ではメソッドが false を返すと予測されるので、Assert.IsFalse メソッドを呼び出すことができます。

ライブラリメソッドでは文字列を処理するため、空の文字列 (String.Empty) および null 文字列を正常に処理することも確認します。空の文字列は、文字を含まない、Length が 0 の文字列です。 null 文字列は、初期化されていない文字列です。しかし、StartsWithUpper を静的メソッドとして直接呼び出して、単一の String 引数を渡すこともできます。または、null に割り当てられた string 変数の拡張メソッドとして StartsWithUpper を呼び出すこともできます。

メソッドを 3 つ定義します。これらのメソッドでは、文字列配列の各要素に対して Assert メソッドが呼び出されます。メソッドのオーバーロードを呼び出します。これにより、テストが失敗した場合に表示されるエラーメッセージを指定できます。このメッセージによって、エラーの原因となった文字列が識別されます。

テストメソッドを作成するには

StringLibraryTest/UnitTest1.cs を開き、すべてのコードを次のコードに置き換えます。

using Microsoft.VisualStudio.TestTools.UnitTesting;
using UtilityLibraries;

namespace StringLibraryTest;

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestStartsWithUpper()
    {
        // Tests that we expect to return true.
        string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
        foreach (var word in words)
        {
            bool result = word.StartsWithUpper();
            Assert.IsTrue(result,
                   string.Format("Expected for '{0}': true; Actual: {1}",
                                 word, result));
        }
    }

    [TestMethod]
    public void TestDoesNotStartWithUpper()
    {
        // Tests that we expect to return false.
        string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
        foreach (var word in words)
        {
            bool result = word.StartsWithUpper();
            Assert.IsFalse(result,
                   string.Format("Expected for '{0}': false; Actual: {1}",
                                 word, result));
        }
    }

    [TestMethod]
    public void DirectCallWithNullOrEmpty()
    {
        // Tests that we expect to return false.
        string?[] words = { string.Empty, null };
        foreach (var word in words)
        {
            bool result = StringLibrary.StartsWithUpper(word);
            Assert.IsFalse(result,
                   string.Format("Expected for '{0}': false; Actual: {1}",
                                 word == null ? "<null>" : word, result));
        }
    }
}

TestStartsWithUpper メソッドの大文字のテストには、ギリシャ語の大文字のアルファ (U+0391) とキリル文字の大文字 EM (U+041C) が含まれています。 TestDoesNotStartWithUpper メソッドの小文字のテストには、ギリシャ語の小文字のアルファ (U+03B1) とキリル文字の小文字 Ghe (U+0433) が含まれています。

変更内容を保存します。

テストを実行します。

dotnet test StringLibraryTest/StringLibraryTest.csproj

次のターミナル出力は、すべてのテストが成功したことを示しています。

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     3, Skipped:     0, Total:     3, Duration: 3 ms - StringLibraryTest.dll (net8.0)

テストの失敗の処理

テスト駆動開発 (TDD) を行っている場合、最初にテストを作成すると、1 回目のテスト実行は失敗します。その後、テストを成功させるコードをアプリに追加します。このチュートリアルでは、検証するアプリコードを記述した後にテストを作成したため、テストが失敗することはありませんでした。テストの失敗が予想されるときにテストが失敗することを検証するには、テスト入力に無効な値を追加します。

TestDoesNotStartWithUpper メソッドの words 配列を変更し、文字列 "Error" を含めます。

string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

テストを実行します。

dotnet test StringLibraryTest/StringLibraryTest.csproj

ターミナルの出力では、1 つのテストが失敗したことが示され、失敗したテストに関するエラーメッセージが表示されます。"Assert.IsFalse failed. Expected for 'Error': false; actual:True" が表示されます。エラーのため、配列内の "Error" の後ろの文字列はテストされませんでした。

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.
  Failed TestDoesNotStartWithUpper [28 ms]
  Error Message:
   Assert.IsFalse failed. Expected for 'Error': false; Actual: True
  Stack Trace:
     at StringLibraryTest.UnitTest1.TestDoesNotStartWithUpper() in C:\ClassLibraryProjects\StringLibraryTest\UnitTest1.cs:line 33

Failed!  - Failed:     1, Passed:     2, Skipped:     0, Total:     3, Duration: 31 ms - StringLibraryTest.dll (net5.0)

手順 1 で追加した文字列 "Error" を削除します。テストを再実行すると、テストは成功します。

ライブラリのリリースバージョンのテスト

これで、ライブラリのデバッグビルドを実行したときにすべてのテストが成功したので、さらにライブラリのリリースビルドに対してテストを行います。コンパイラの最適化などのさまざまな要因により、デバッグビルドとリリースビルドとでは動作が異なる場合があります。

リリースビルド構成を使用してテストを実行します。
```
dotnet test StringLibraryTest/StringLibraryTest.csproj --configuration Release
```
テストが成功します。

テストのデバッグ

IDE として Visual Studio Code を使用する場合は、「Visual Studio Code を使用して .NET コンソールアプリケーションをデバッグする」に示されているのと同じプロセスを使用し、単体テストプロジェクトを使ってコードをデバッグできます。 ShowCase アプリプロジェクトを開始する代わりに、StringLibraryTest/UnitTest1.cs を開き、7 行目と 8 行目の間で [すべてのテストをデバッグする] を選択します。見つからない場合は、Ctrl+Shift+P キーを押してコマンドパレットを開き、「Reload Window」と入力します。

Visual Studio Code により、デバッガーがアタッチされた状態でテストプロジェクトが開始されます。実行は、テストプロジェクトまたは基になるライブラリコードに追加したブレークポイントで停止します。

その他の技術情報

.NET での単体テスト

次の手順

このチュートリアルでは、クラスライブラリの単体テストを行いました。ライブラリをパッケージとして NuGet に発行した場合、他のユーザーもそれを使用できます。方法については、次の NuGet のチュートリアルに従ってください。

dotnet CLI を使用したパッケージの作成と公開

ライブラリを NuGet パッケージとして発行した場合、他のユーザーもそれをインストールして使用できます。方法については、次の NuGet のチュートリアルに従ってください。

dotnet CLI を使用してパッケージをインストールし使用する

ライブラリはパッケージとして配布する必要はありません。それが使用されるコンソールアプリにバンドルすることができます。コンソールアプリを発行する方法については、このシリーズの前のチュートリアルを参照してください。

Visual Studio Code を使用して .NET コンソールアプリケーションを発行する

Visual Studio Code 拡張機能 C# Dev Kit には、C# アプリとライブラリを開発するためのさらに多くのツールが用意されています。

C# 開発キット

このチュートリアルでは、テストプロジェクトをソリューションに追加して、単体テストを自動化する方法について説明します。

必須コンポーネント

このチュートリアルでは、「Visual Studio Code を使用して .NET クラスライブラリを作成する」で作成するソリューションを使用します。

単体テストプロジェクトを作成する

単体テストでは、開発および公開時に自動化されたソフトウェアテストが提供されます。このチュートリアルで使用するテストフレームワークは MSTest です。 MSTest は、選択できる 3 つのテストフレームワークのうちの 1 つです。これ以外は、xUnit と nUnit です。

Visual Studio Code を開始します。
「Visual Studio Code を使用して .NET クラスライブラリを作成する」で作成した ClassLibraryProjects ソリューションを開きます。
「StringLibraryTest」という名前の単体テストプロジェクトを作成します。
```
dotnet new mstest -o StringLibraryTest
```
プロジェクトテンプレートでは、次のコードを使用して UnitTest1.cs ファイルを作成します。
```
using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestMethod1()
        {
        }
    }
}
```
単体テストのテンプレートで作成されたソースコードにより、次の処理が行われます。
- 単体テストで使用される型が含まれた Microsoft.VisualStudio.TestTools.UnitTesting 名前空間がインポートされます。
- TestClassAttribute 属性が UnitTest1 クラスに適用されます。
- TestMethodAttribute 属性を適用して TestMethod1 を定義します。
[TestClass] でタグ付けされたテストクラスの [TestMethod] でタグ付けされた各テストメソッドが、単体テスト実行時に自動実行されます。
次のように、テストプロジェクトをソリューションに追加します。
```
dotnet sln add StringLibraryTest/StringLibraryTest.csproj
```

プロジェクト参照を追加する

テストプロジェクトが StringLibrary クラスと連動するように、StringLibraryTest プロジェクトに StringLibrary プロジェクトへの参照を追加します。

次のコマンドを実行します。

dotnet add StringLibraryTest/StringLibraryTest.csproj reference StringLibrary/StringLibrary.csproj

単体テストメソッドの追加と実行

Visual Studio で単体テストを実行すると、TestClassAttribute 属性でマークされたクラス内で、TestMethodAttribute 属性でマークされた各メソッドが実行されます。テストメソッドは、最初の失敗が検出されたとき、またはそのメソッドに含まれているすべてのテストが成功したときに終了します。

一般的なテストでは、Assert クラスのメンバーが呼び出されます。多くのアサートメソッドは最低 2 つのパラメーターを含んでいます。1 つは予期されるテスト結果、もう 1 つは実際のテスト結果です。次の表に、Assert クラスの頻繁に呼び出されるメソッドをいくつか示します。

Assert メソッド	関数
`Assert.AreEqual`	2 つの値または 2 つのオブジェクトが等しいことを確認します。値またはオブジェクトが等しくない場合、アサートは失敗します。
`Assert.AreSame`	2 つのオブジェクト変数が同じオブジェクトを参照していることを確認します。変数が別々のオブジェクトを参照している場合、アサートは失敗します。
`Assert.IsFalse`	条件が `false` であることを確認します。条件が `true` の場合、アサートは失敗します。
`Assert.IsNotNull`	オブジェクトが `null` でないことを確認します。オブジェクトが `null` である場合、アサートは失敗します。

また、テストメソッドで Assert.ThrowsException メソッドを使用して、スローすることが期待される例外の種類を示すこともできます。指定した例外がスローされない場合、テストは失敗します。

StringLibrary.StartsWithUpper メソッドのテストでは、大文字で始まる文字列を多く用意します。これらの場合ではメソッドが true を返すと予測されるので、Assert.IsTrue メソッドを呼び出すことができます。同様に、大文字以外で始まる文字列を多く用意します。これらの場合ではメソッドが false を返すと予測されるので、Assert.IsFalse メソッドを呼び出すことができます。

ライブラリメソッドでは文字列を処理するため、空の文字列 (String.Empty) および null 文字列を正常に処理することも確認します。空の文字列は、文字を含まない、Length が 0 の文字列です。 null 文字列は、初期化されていない文字列です。しかし、StartsWithUpper を静的メソッドとして直接呼び出して、単一の String 引数を渡すこともできます。または、null に割り当てられた string 変数の拡張メソッドとして StartsWithUpper を呼び出すこともできます。

メソッドを 3 つ定義します。これらのメソッドでは、文字列配列の各要素に対して Assert メソッドが呼び出されます。メソッドのオーバーロードを呼び出します。これにより、テストが失敗した場合に表示されるエラーメッセージを指定できます。このメッセージによって、エラーの原因となった文字列が識別されます。

テストメソッドを作成するには

StringLibraryTest/UnitTest1.cs を開き、すべてのコードを次のコードに置き換えます。

using Microsoft.VisualStudio.TestTools.UnitTesting;
using UtilityLibraries;

namespace StringLibraryTest;

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestStartsWithUpper()
    {
        // Tests that we expect to return true.
        string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
        foreach (var word in words)
        {
            bool result = word.StartsWithUpper();
            Assert.IsTrue(result,
                   string.Format("Expected for '{0}': true; Actual: {1}",
                                 word, result));
        }
    }

    [TestMethod]
    public void TestDoesNotStartWithUpper()
    {
        // Tests that we expect to return false.
        string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
        foreach (var word in words)
        {
            bool result = word.StartsWithUpper();
            Assert.IsFalse(result,
                   string.Format("Expected for '{0}': false; Actual: {1}",
                                 word, result));
        }
    }

    [TestMethod]
    public void DirectCallWithNullOrEmpty()
    {
        // Tests that we expect to return false.
        string?[] words = { string.Empty, null };
        foreach (var word in words)
        {
            bool result = StringLibrary.StartsWithUpper(word);
            Assert.IsFalse(result,
                   string.Format("Expected for '{0}': false; Actual: {1}",
                                 word == null ? "<null>" : word, result));
        }
    }
}

TestStartsWithUpper メソッドの大文字のテストには、ギリシャ語の大文字のアルファ (U+0391) とキリル文字の大文字 EM (U+041C) が含まれています。 TestDoesNotStartWithUpper メソッドの小文字のテストには、ギリシャ語の小文字のアルファ (U+03B1) とキリル文字の小文字 Ghe (U+0433) が含まれています。

変更内容を保存します。

テストを実行します。

dotnet test StringLibraryTest/StringLibraryTest.csproj

次のターミナル出力は、すべてのテストが成功したことを示しています。

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     3, Skipped:     0, Total:     3, Duration: 3 ms - StringLibraryTest.dll (net7.0)

テストの失敗の処理

テスト駆動開発 (TDD) を行っている場合、最初にテストを作成すると、1 回目のテスト実行は失敗します。その後、テストを成功させるコードをアプリに追加します。このチュートリアルでは、検証するアプリコードを記述した後にテストを作成したため、テストが失敗することはありませんでした。テストの失敗が予想されるときにテストが失敗することを検証するには、テスト入力に無効な値を追加します。

TestDoesNotStartWithUpper メソッドの words 配列を変更し、文字列 "Error" を含めます。

string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

テストを実行します。

dotnet test StringLibraryTest/StringLibraryTest.csproj

ターミナルの出力では、1 つのテストが失敗したことが示され、失敗したテストに関するエラーメッセージが表示されます。"Assert.IsFalse failed. Expected for 'Error': false; actual:True" が表示されます。エラーのため、配列内の "Error" の後ろの文字列はテストされませんでした。

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.
  Failed TestDoesNotStartWithUpper [28 ms]
  Error Message:
   Assert.IsFalse failed. Expected for 'Error': false; Actual: True
  Stack Trace:
     at StringLibraryTest.UnitTest1.TestDoesNotStartWithUpper() in C:\ClassLibraryProjects\StringLibraryTest\UnitTest1.cs:line 33

Failed!  - Failed:     1, Passed:     2, Skipped:     0, Total:     3, Duration: 31 ms - StringLibraryTest.dll (net5.0)

手順 1 で追加した文字列 "Error" を削除します。テストを再実行すると、テストは成功します。

ライブラリのリリースバージョンのテスト

これで、ライブラリのデバッグビルドを実行したときにすべてのテストが成功したので、さらにライブラリのリリースビルドに対してテストを行います。コンパイラの最適化などのさまざまな要因により、デバッグビルドとリリースビルドとでは動作が異なる場合があります。

リリースビルド構成を使用してテストを実行します。
```
dotnet test StringLibraryTest/StringLibraryTest.csproj --configuration Release
```
テストが成功します。

テストのデバッグ

IDE として Visual Studio Code を使用する場合は、「Visual Studio Code を使用して .NET コンソールアプリケーションをデバッグする」に示されているのと同じプロセスを使用し、単体テストプロジェクトを使ってコードをデバッグできます。 ShowCase アプリプロジェクトを開始する代わりに、StringLibraryTest/UnitTest1.cs を開き、7 行目と 8 行目の間で [すべてのテストをデバッグする] を選択します。見つからない場合は、Ctrl+Shift+P キーを押してコマンドパレットを開き、「Reload Window」と入力します。

Visual Studio Code により、デバッガーがアタッチされた状態でテストプロジェクトが開始されます。実行は、テストプロジェクトまたは基になるライブラリコードに追加したブレークポイントで停止します。

その他の技術情報

.NET での単体テスト

次の手順

このチュートリアルでは、クラスライブラリの単体テストを行いました。ライブラリをパッケージとして NuGet に発行した場合、他のユーザーもそれを使用できます。方法については、次の NuGet のチュートリアルに従ってください。

dotnet CLI を使用したパッケージの作成と公開

ライブラリを NuGet パッケージとして発行した場合、他のユーザーもそれをインストールして使用できます。方法については、次の NuGet のチュートリアルに従ってください。

dotnet CLI を使用してパッケージをインストールし使用する

ライブラリはパッケージとして配布する必要はありません。それが使用されるコンソールアプリにバンドルすることができます。コンソールアプリを発行する方法については、このシリーズの前のチュートリアルを参照してください。

Visual Studio Code を使用して .NET コンソールアプリケーションを発行する

このチュートリアルでは、テストプロジェクトをソリューションに追加して、単体テストを自動化する方法について説明します。

必須コンポーネント

このチュートリアルでは、「Visual Studio Code を使用して .NET クラスライブラリを作成する」で作成するソリューションを使用します。

単体テストプロジェクトを作成する

単体テストでは、開発および公開時に自動化されたソフトウェアテストが提供されます。このチュートリアルで使用するテストフレームワークは MSTest です。 MSTest は、選択できる 3 つのテストフレームワークのうちの 1 つです。これ以外は、xUnit と nUnit です。

Visual Studio Code を開始します。
「Visual Studio Code を使用して .NET クラスライブラリを作成する」で作成した ClassLibraryProjects ソリューションを開きます。
「StringLibraryTest」という名前の単体テストプロジェクトを作成します。
```
dotnet new mstest -f net6.0 -o StringLibraryTest
```
-f net6.0 コマンドは、既定のターゲットフレームワークを net6.0 バージョンに変更します。

-o コマンドまたは --output コマンドによって、生成された出力を配置する場所が指定されます。

プロジェクトテンプレートでは、次のコードを使用して UnitTest1.cs ファイルを作成します。
```
using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestMethod1()
        {
        }
    }
}
```
単体テストのテンプレートで作成されたソースコードにより、次の処理が行われます。
- 単体テストで使用される型が含まれた Microsoft.VisualStudio.TestTools.UnitTesting 名前空間がインポートされます。
- TestClassAttribute 属性が UnitTest1 クラスに適用されます。
- TestMethodAttribute 属性を適用して TestMethod1 を定義します。
[TestClass] でタグ付けされたテストクラスの [TestMethod] でタグ付けされた各テストメソッドが、単体テスト実行時に自動実行されます。
次のように、テストプロジェクトをソリューションに追加します。
```
dotnet sln add StringLibraryTest/StringLibraryTest.csproj
```

プロジェクト参照を追加する

テストプロジェクトが StringLibrary クラスと連動するように、StringLibraryTest プロジェクトに StringLibrary プロジェクトへの参照を追加します。

次のコマンドを実行します。

dotnet add StringLibraryTest/StringLibraryTest.csproj reference StringLibrary/StringLibrary.csproj

単体テストメソッドの追加と実行

Visual Studio で単体テストを実行すると、TestClassAttribute 属性でマークされたクラス内で、TestMethodAttribute 属性でマークされた各メソッドが実行されます。テストメソッドは、最初の失敗が検出されたとき、またはそのメソッドに含まれているすべてのテストが成功したときに終了します。

一般的なテストでは、Assert クラスのメンバーが呼び出されます。多くのアサートメソッドは最低 2 つのパラメーターを含んでいます。1 つは予期されるテスト結果、もう 1 つは実際のテスト結果です。次の表に、Assert クラスの頻繁に呼び出されるメソッドをいくつか示します。

Assert メソッド	関数
`Assert.AreEqual`	2 つの値または 2 つのオブジェクトが等しいことを確認します。値またはオブジェクトが等しくない場合、アサートは失敗します。
`Assert.AreSame`	2 つのオブジェクト変数が同じオブジェクトを参照していることを確認します。変数が別々のオブジェクトを参照している場合、アサートは失敗します。
`Assert.IsFalse`	条件が `false` であることを確認します。条件が `true` の場合、アサートは失敗します。
`Assert.IsNotNull`	オブジェクトが `null` でないことを確認します。オブジェクトが `null` である場合、アサートは失敗します。

また、テストメソッドで Assert.ThrowsException メソッドを使用して、スローすることが期待される例外の種類を示すこともできます。指定した例外がスローされない場合、テストは失敗します。

StringLibrary.StartsWithUpper メソッドのテストでは、大文字で始まる文字列を多く用意します。これらの場合ではメソッドが true を返すと予測されるので、Assert.IsTrue メソッドを呼び出すことができます。同様に、大文字以外で始まる文字列を多く用意します。これらの場合ではメソッドが false を返すと予測されるので、Assert.IsFalse メソッドを呼び出すことができます。

ライブラリメソッドでは文字列を処理するため、空の文字列 (String.Empty) および null 文字列を正常に処理することも確認します。空の文字列は、文字を含まない、Length が 0 の文字列です。 null 文字列は、初期化されていない文字列です。しかし、StartsWithUpper を静的メソッドとして直接呼び出して、単一の String 引数を渡すこともできます。または、null に割り当てられた string 変数の拡張メソッドとして StartsWithUpper を呼び出すこともできます。

メソッドを 3 つ定義します。これらのメソッドでは、文字列配列の各要素に対して Assert メソッドが呼び出されます。メソッドのオーバーロードを呼び出します。これにより、テストが失敗した場合に表示されるエラーメッセージを指定できます。このメッセージによって、エラーの原因となった文字列が識別されます。

テストメソッドを作成するには

StringLibraryTest/UnitTest1.cs を開き、すべてのコードを次のコードに置き換えます。

using Microsoft.VisualStudio.TestTools.UnitTesting;
using UtilityLibraries;

namespace StringLibraryTest;

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestStartsWithUpper()
    {
        // Tests that we expect to return true.
        string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
        foreach (var word in words)
        {
            bool result = word.StartsWithUpper();
            Assert.IsTrue(result,
                   string.Format("Expected for '{0}': true; Actual: {1}",
                                 word, result));
        }
    }

    [TestMethod]
    public void TestDoesNotStartWithUpper()
    {
        // Tests that we expect to return false.
        string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
        foreach (var word in words)
        {
            bool result = word.StartsWithUpper();
            Assert.IsFalse(result,
                   string.Format("Expected for '{0}': false; Actual: {1}",
                                 word, result));
        }
    }

    [TestMethod]
    public void DirectCallWithNullOrEmpty()
    {
        // Tests that we expect to return false.
        string?[] words = { string.Empty, null };
        foreach (var word in words)
        {
            bool result = StringLibrary.StartsWithUpper(word);
            Assert.IsFalse(result,
                   string.Format("Expected for '{0}': false; Actual: {1}",
                                 word == null ? "<null>" : word, result));
        }
    }
}

TestStartsWithUpper メソッドの大文字のテストには、ギリシャ語の大文字のアルファ (U+0391) とキリル文字の大文字 EM (U+041C) が含まれています。 TestDoesNotStartWithUpper メソッドの小文字のテストには、ギリシャ語の小文字のアルファ (U+03B1) とキリル文字の小文字 Ghe (U+0433) が含まれています。

変更内容を保存します。

テストを実行します。

dotnet test StringLibraryTest/StringLibraryTest.csproj

次のターミナル出力は、すべてのテストが成功したことを示しています。

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     3, Skipped:     0, Total:     3, Duration: 3 ms - StringLibraryTest.dll (net6.0)

テストの失敗の処理

テスト駆動開発 (TDD) を行っている場合、最初にテストを作成すると、1 回目のテスト実行は失敗します。その後、テストを成功させるコードをアプリに追加します。このチュートリアルでは、検証するアプリコードを記述した後にテストを作成したため、テストが失敗することはありませんでした。テストの失敗が予想されるときにテストが失敗することを検証するには、テスト入力に無効な値を追加します。

TestDoesNotStartWithUpper メソッドの words 配列を変更し、文字列 "Error" を含めます。

string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

テストを実行します。

dotnet test StringLibraryTest/StringLibraryTest.csproj

ターミナルの出力では、1 つのテストが失敗したことが示され、失敗したテストに関するエラーメッセージが表示されます。"Assert.IsFalse failed. Expected for 'Error': false; actual:True" が表示されます。エラーのため、配列内の "Error" の後ろの文字列はテストされませんでした。

Starting test execution, please wait...
A total of 1 test files matched the specified pattern.
  Failed TestDoesNotStartWithUpper [28 ms]
  Error Message:
   Assert.IsFalse failed. Expected for 'Error': false; Actual: True
  Stack Trace:
     at StringLibraryTest.UnitTest1.TestDoesNotStartWithUpper() in C:\ClassLibraryProjects\StringLibraryTest\UnitTest1.cs:line 33

Failed!  - Failed:     1, Passed:     2, Skipped:     0, Total:     3, Duration: 31 ms - StringLibraryTest.dll (net5.0)

手順 1 で追加した文字列 "Error" を削除します。テストを再実行すると、テストは成功します。

ライブラリのリリースバージョンのテスト

これで、ライブラリのデバッグビルドを実行したときにすべてのテストが成功したので、さらにライブラリのリリースビルドに対してテストを行います。コンパイラの最適化などのさまざまな要因により、デバッグビルドとリリースビルドとでは動作が異なる場合があります。

リリースビルド構成を使用してテストを実行します。
```
dotnet test StringLibraryTest/StringLibraryTest.csproj --configuration Release
```
テストが成功します。

テストのデバッグ

IDE として Visual Studio Code を使用する場合は、「Visual Studio Code を使用して .NET コンソールアプリケーションをデバッグする」に示されているのと同じプロセスを使用し、単体テストプロジェクトを使ってコードをデバッグできます。 ShowCase アプリプロジェクトを開始する代わりに、StringLibraryTest/UnitTest1.cs を開き、7 行目と 8 行目の間で [すべてのテストをデバッグする] を選択します。見つからない場合は、Ctrl+Shift+P キーを押してコマンドパレットを開き、「Reload Window」と入力します。

Visual Studio Code により、デバッガーがアタッチされた状態でテストプロジェクトが開始されます。実行は、テストプロジェクトまたは基になるライブラリコードに追加したブレークポイントで停止します。

その他の技術情報

.NET での単体テスト

次の手順

このチュートリアルでは、クラスライブラリの単体テストを行いました。ライブラリをパッケージとして NuGet に発行した場合、他のユーザーもそれを使用できます。方法については、次の NuGet のチュートリアルに従ってください。

dotnet CLI を使用したパッケージの作成と公開

ライブラリを NuGet パッケージとして発行した場合、他のユーザーもそれをインストールして使用できます。方法については、次の NuGet のチュートリアルに従ってください。

dotnet CLI を使用してパッケージをインストールし使用する

ライブラリはパッケージとして配布する必要はありません。それが使用されるコンソールアプリにバンドルすることができます。コンソールアプリを発行する方法については、このシリーズの前のチュートリアルを参照してください。

Visual Studio Code を使用して .NET コンソールアプリケーションを発行する

次の方法で共有

チュートリアル: Visual Studio Code を使用して .NET クラスライブラリをテストする

必須コンポーネント

単体テストプロジェクトを作成する

プロジェクト参照を追加する

単体テストメソッドの追加と実行

テストの失敗の処理

ライブラリのリリースバージョンのテスト

テストのデバッグ

その他の技術情報

次の手順

必須コンポーネント

単体テストプロジェクトを作成する

プロジェクト参照を追加する

単体テストメソッドの追加と実行

テストの失敗の処理

ライブラリのリリースバージョンのテスト

テストのデバッグ

その他の技術情報

次の手順

必須コンポーネント

単体テストプロジェクトを作成する

プロジェクト参照を追加する

単体テストメソッドの追加と実行

テストの失敗の処理

ライブラリのリリースバージョンのテスト

テストのデバッグ

その他の技術情報

次の手順

その他のリソース

次の方法で共有

チュートリアル: Visual Studio Code を使用して .NET クラス ライブラリをテストする

必須コンポーネント

単体テスト プロジェクトを作成する

プロジェクト参照を追加する

単体テスト メソッドの追加と実行

テストの失敗の処理

ライブラリのリリース バージョンのテスト

テストのデバッグ

その他の技術情報

次の手順

必須コンポーネント

単体テスト プロジェクトを作成する

プロジェクト参照を追加する

単体テスト メソッドの追加と実行

テストの失敗の処理

ライブラリのリリース バージョンのテスト

テストのデバッグ

その他の技術情報

次の手順

必須コンポーネント

単体テスト プロジェクトを作成する

プロジェクト参照を追加する

単体テスト メソッドの追加と実行

テストの失敗の処理

ライブラリのリリース バージョンのテスト

テストのデバッグ

その他の技術情報

次の手順

その他のリソース

チュートリアル: Visual Studio Code を使用して .NET クラスライブラリをテストする

単体テストプロジェクトを作成する

単体テストメソッドの追加と実行

ライブラリのリリースバージョンのテスト

単体テストプロジェクトを作成する

単体テストメソッドの追加と実行

ライブラリのリリースバージョンのテスト

単体テストプロジェクトを作成する

単体テストメソッドの追加と実行

ライブラリのリリースバージョンのテスト