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

[アーティクル]
12/30/2024

このチュートリアルでは、1 つの文字列処理メソッドを含む単純なクラスライブラリを作成します。

クラスライブラリ は、アプリケーションによって呼び出される型とメソッドを定義します。ライブラリが .NET Standard 2.0 を対象とする場合は、.NET Standard 2.0 をサポートする任意の .NET 実装 (.NET Framework を含む) によって呼び出すことができます。ライブラリが .NET 8 を対象とする場合は、.NET 8 を対象とする任意のアプリケーションから呼び出すことができます。このチュートリアルでは、.NET 8 をターゲットにする方法について説明します。

クラスライブラリを作成するときに、NuGet パッケージとして、またはそれを使用するアプリケーションにバンドルされたコンポーネントとして配布できます。

前提条件

.NET デスクトップ開発ワークロードがインストールされた Visual Studio 2022。このワークロードを選択すると、.NET 8 SDK が自動的にインストールされます。

詳細については、「Visual Studioを使用した .NET SDK のインストール」を参照してください。

ソリューションを作成する

まず、クラスライブラリプロジェクトを配置する空のソリューションを作成します。 Visual Studio ソリューションは、1 つ以上のプロジェクトのコンテナーとして機能します。関連するプロジェクトを同じソリューションに追加します。

空のソリューションを作成するには:

Visual Studio を起動します。
スタートウィンドウで、[新しいプロジェクト作成] を選択します。
[新しいプロジェクト の作成] ページで、検索ボックス ソリューション を入力します。 空白のソリューション テンプレートを選択し、次に [次へ]を選択します。

Visual Studio で空のソリューションテンプレートをする
[新しいプロジェクト の構成] ページで、[ソリューション名] ボックスに「ClassLibraryProjects」と入力します。次に、を選択して、を作成します。

クラスライブラリプロジェクトを作成する

"StringLibrary" という名前の新しい .NET クラスライブラリプロジェクトをソリューションに追加します。
1. ソリューションエクスプローラーのでソリューションを右クリックし、[追加] を選択し、[新しいプロジェクト] を選択します。
2. [新しいプロジェクト の追加] ページで、検索ボックス ライブラリ を入力します。 [言語] の一覧から [C# または Visual Basic をし、[プラットフォーム] の一覧から [すべてのプラットフォームを ] を選択します。 [クラスライブラリ] テンプレートを選んでから、[次へ] を選択します。
3. [新しいプロジェクト の構成] ページで、[プロジェクト名] ボックスに 「StringLibrary」 を入力し、[次へ]を選択します。
4. [追加情報] ページで、[.NET 8] を選択し、次に、[作成] を選択します。
ライブラリが正しいバージョンの .NET を対象としていることを確認します。ソリューションエクスプローラーのでライブラリプロジェクト右クリックし、[プロパティ]選択します。 Target Framework テキストボックスには、プロジェクトが .NET 8.0 を対象としていることを示します。
Visual Basic を使用している場合は、ルート名前空間 テキストボックスのテキストをクリアします。

クラスライブラリのプロジェクトプロパティをに設定する

プロジェクトごとに、プロジェクト名に対応する名前空間が Visual Basic によって自動的に作成されます。このチュートリアルでは、コードファイルで namespace キーワードを使用して、最上位レベルの名前空間を定義します。
Class1.cs または Class1.vb のコードウィンドウのコードを次のコードに置き換え、ファイルを保存します。使用する言語が表示されない場合は、ページの上部にある言語セレクターを変更します。
```
using System;

namespace UtilityLibraries
{
    public static class StringLibrary
    {
        public static bool StartsWithUpper(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
                return false;

            char ch = str[0];
            return char.IsUpper(ch);
        }
    }
}
```
```
Imports System.Runtime.CompilerServices

Namespace UtilityLibraries
    Public Module StringLibrary
        <Extension>
        Public Function StartsWithUpper(str As String) As Boolean
            If String.IsNullOrWhiteSpace(str) Then
                Return False
            End If

            Dim ch As Char = str(0)
            Return Char.IsUpper(ch)
        End Function
    End Module
End Namespace
```
クラスライブラリ UtilityLibraries.StringLibraryには、StartsWithUpperという名前のメソッドが含まれています。このメソッドは、現在の文字列インスタンスが大文字で始まるかどうかを示す Boolean 値を返します。 Unicode 標準では、大文字と小文字が区別されます。 Char.IsUpper(Char) メソッドは、文字が大文字の場合は true を返します。

は、クラスのメンバーであるかのように呼び出すことができるように、拡張メソッドとして実装されます。 C# コードで string した後の疑問符 (?) は、文字列が null である可能性があることを示します。
メニューバーで、[ビルド>] の [ビルドソリューション] を選択するか、Ctrl+Shift+B キーを押して、プロジェクトがエラーなくコンパイルされることを確認します。

ソリューションにコンソールアプリを追加する

クラスライブラリを使用するコンソールアプリケーションを追加します。アプリはユーザーに文字列の入力を求め、文字列が大文字で始まるかどうかを報告します。

"ShowCase" という名前の新しい .NET コンソールアプリケーションをソリューションに追加します。
1. ソリューションエクスプローラーのでソリューション右クリックし、[新しいプロジェクト追加] 選択します。
2. [新しいプロジェクト の追加] ページで、検索ボックスに コンソール を入力します。 [言語] の一覧から [C# または Visual Basic をし、[プラットフォーム] の一覧から [すべてのプラットフォームを ] を選択します。
3. コンソールアプリケーションテンプレートを選択し、[次へ]選択します。
4. [新しいプロジェクトの構成] ページで、[プロジェクト名] ボックスに「ShowCase」と入力します。次を選択します。
5. [追加情報] ページの [フレームワーク] ボックスの [.NET 8] を選択します。次に、 [作成] を選択します。

Program.cs または Program.vb ファイルのコードウィンドウで、すべてのコードを次のコードに置き換えます。

using System;
using UtilityLibraries;

class Program
{
    static void Main(string[] args)
    {
        int row = 0;

        do
        {
            if (row == 0 || row >= 25)
                ResetConsole();

            string? input = Console.ReadLine();
            if (string.IsNullOrEmpty(input)) break;
            Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                              $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
            row += 3;
        } while (true);
        return;

        // Declare a ResetConsole local method
        void ResetConsole()
        {
            if (row > 0)
            {
                Console.WriteLine("Press any key to continue...");
                Console.ReadKey();
            }
            Console.Clear();
            Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
            row = 3;
        }
    }
}

Imports UtilityLibraries

Module Program
    Dim row As Integer = 0

    Sub Main()
        Do
            If row = 0 OrElse row >= 25 Then ResetConsole()

            Dim input As String = Console.ReadLine()
            If String.IsNullOrEmpty(input) Then Return

            Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                              $"{If(input.StartsWithUpper(), "Yes", "No")} {Environment.NewLine}")
            row += 3
        Loop While True
    End Sub

    Private Sub ResetConsole()
        If row > 0 Then
            Console.WriteLine("Press any key to continue...")
            Console.ReadKey()
        End If   
        Console.Clear()
        Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}")
        row = 3  
    End Sub
End Module

このコードでは、row 変数を使用して、コンソールウィンドウに書き込まれたデータ行の数を保持します。 25 以上の場合は常に、コンソールウィンドウがクリアされ、ユーザーにメッセージが表示されます。

プログラムは、ユーザーに文字列の入力を求めます。文字列が大文字で始まるかどうかを示します。ユーザーが文字列を入力せずに Enter キーを押すと、アプリケーションが終了し、コンソールウィンドウが閉じます。

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

最初は、新しいコンソールアプリプロジェクトにはクラスライブラリへのアクセス権がありません。クラスライブラリ内のメソッドを呼び出せるようにするには、クラスライブラリプロジェクトへのプロジェクト参照を作成します。

ソリューションエクスプローラーで、プロジェクトの [依存関係] ノードを右クリックし、[プロジェクト参照の追加]選択します。

で参照コンテキストメニューを追加する
[参照マネージャー] ダイアログボックスで、[StringLibrary] プロジェクトを選び、[OK] を選びます。

アプリを実行する

ソリューションエクスプローラーで、ShowCase プロジェクトを右クリックし、コンテキストメニューの [スタートアッププロジェクトとして設定] 選択します。

Visual Studio プロジェクトのコンテキストメニューを使用して
CtrlF5 押して、デバッグなしでプログラムをコンパイルして実行します。
文字列を入力してEnterキーを押すとプログラムを試すことができ、終了するにはEnterキーを押します。

その他のリソース

.NET CLI を使用してライブラリを開発する
.NET Standard のバージョンと、をサポートするプラットフォームです。

次の手順

このチュートリアルでは、クラスライブラリを作成しました。次のチュートリアルでは、クラスライブラリを単体テストする方法について説明します。

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

または、自動単体テストをスキップし、NuGet パッケージを作成してライブラリを共有する方法を学習することもできます。

Visual Studio を使用してパッケージを作成して発行する

または、コンソールアプリを発行する方法について説明します。このチュートリアルで作成したソリューションからコンソールアプリを発行すると、クラスライブラリは .dll ファイルとして使用されます。

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

次の方法で共有

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

前提 条件

ソリューションを作成する

クラス ライブラリ プロジェクトを作成する

ソリューションにコンソール アプリを追加する

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

アプリを実行する

その他のリソース

次の手順

その他のリソース

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

前提条件

クラスライブラリプロジェクトを作成する

ソリューションにコンソールアプリを追加する