チュートリアル: .NET クラスライブラリを作成する

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

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

クラスライブラリを作成する場合は、サードパーティのコンポーネントとして、または 1 つ以上のアプリケーションにバンドルされたコンポーネントとして配布できます。

[前提条件]

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

詳細については、「 Visual Studioを参照してください。

最新の .NET SDK
Visual Studio Code エディター
C# DevKit

インストール手順

Windows、このWinGet 構成ファイルは、すべての前提条件をインストールします。既に何かがインストールされている場合、WinGet はその手順をスキップします。

ファイルをダウンロードし、ダブルクリックして実行します。
使用許諾契約書を読み、y と入力し、同意を求められたら Enter キーを選択します。
タスクバーで点滅するユーザーアカウント制御 (UAC) プロンプトが表示された場合は、インストールを続行します。

他のプラットフォームでは、これらの各コンポーネントを個別にインストールする必要があります。

推奨されるインストーラーを .NET SDK ダウンロードページからダウンロードし、ダブルクリックして実行します。ダウンロードページでプラットフォームが検出され、プラットフォームの最新のインストーラーが推奨されます。
Visual Studio Codeホームページから最新のインストーラーをダウンロードし、ダブルクリックして実行します。このページではプラットフォームも検出され、リンクはシステムに適している必要があります。
C# DevKit 拡張機能ページの [インストール] ボタンをクリックします。 Visual Studio Codeを開き、拡張機能をインストールするか有効にするかを尋ねるメッセージが表示されます。 [インストール] を選択します。

GitHub Codespaces を使用するGitHub アカウント。まだお持ちでない場合は、GitHub.com で無料アカウントを作成できます。

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

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

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

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

まず、"StringLibrary" という名前の.NET クラスライブラリプロジェクトと、関連付けられているソリューションを作成します。ソリューションは、1 つ以上のプロジェクトのコンテナーとして機能します。関連するプロジェクトを同じソリューションに追加します。

Visual Studio Codeを開始します。
エクスプローラービューに移動し、[プロジェクトの .NET作成] を選択>。または、Ctrl + Shift + P (MacOS の場合は Command + Shift + P) を使用してコマンドパレットを表示し、「.NET」と入力し、.NET: [新しいプロジェクト] コマンドを見つけて選択することもできます。
プロジェクトテンプレートの クラスライブラリを選択します。
次に、新しいプロジェクトを作成する場所を選択します。ClassLibraryProjects という名前のフォルダーを作成して選択します。
プロジェクトに StringLibrary という名前を付けます。
ソリューションファイル形式として .sln を選択します。
[ すべてのテンプレートオプションを表示] を選択します。
次に、.NET 10 を選択します。次に、[ プロジェクトの作成] を選択します。
[ このフォルダー内のファイルの作成者を信頼しますか? ] ダイアログで、[ はい、作成者を信頼します] を選択します。このフォルダーには、.NETによって生成され、ユーザーによって追加または変更されたファイルのみが含まれているため、作成者を信頼できます。

まず、チュートリアル環境で GitHub Codespace を作成してから、.NET クラスライブラリプロジェクトを作成します。

ブラウザーウィンドウを開き、チュートリアルの codespace リポジトリに移動します。
緑色の [コード ] ボタンを選択し、[ Codespaces ] タブを選択します。
この環境を使用して新しい Codespace を作成するには、 + 記号または 緑色の [メインのコードスペース の作成] ボタンを選択します。
codespace が読み込まれたら、ターミナルを開き、tutorials フォルダーに移動します。
```
cd tutorials
```
新しいクラスライブラリプロジェクトを作成します。
```
dotnet new classlib -n StringLibrary
```

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

StringLibrary という名前の新しい.NET クラスライブラリプロジェクトをソリューションに追加します。
1. Solution Explorer でソリューションを右クリックし、Add>New Project を選択します。
2. [新しいプロジェクト の追加] ページで、検索ボックス ライブラリ を入力します。言語の一覧から C# または Visual Basic を選択し、プラットフォームの一覧から All platforms を選択します。 [クラスライブラリ] テンプレートを選んでから、[次へ] を選択します。
3. [新しいプロジェクト の構成] ページで、[プロジェクト名] ボックスに 「StringLibrary」 を入力し、[次へ]を選択します。
4. 追加情報 ページで、.NET 10 を選択し、 Create を選択します。
ライブラリが正しいバージョンの.NETを対象としていることを確認します。 Solution Explorerでライブラリプロジェクトを右クリックし、 Propertiesを選択します。 Target Framework テキストボックスには、プロジェクトのターゲットが 10.0 .NET示されます。
Visual Basicを使用している場合は、Default 名前空間 テキストボックスのテキストをクリアします。

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

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

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

        return char.IsUpper(str[0]);
    }
}
```
```
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 キーを押して、プロジェクトがエラーなくコンパイルされることを確認します。

プロジェクトが作成され、 Class1.cs が開きます。
Class1.csの内容を次のコードに置き換えます。
```
namespace UtilityLibraries;

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

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

は、クラスのメンバーであるかのように呼び出すことができるように、拡張メソッドとして実装されます。
ファイルを保存します。
展開します Solution Explorer は Explorer ビューの下部にあります。
Solution Explorer でソリューションを右クリックし、Build を選択するか、コマンドパレットを開いて .NET: Build を選択してソリューションをビルドし、プロジェクトがエラーなしでコンパイルされることを確認します。

ターミナル出力は次の例のようになります。
```
  Determining projects to restore...
  All projects are up-to-date for restore.
  StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net10.0\StringLibrary.dll
Build succeeded.
    0 Warning(s)
    0 Error(s)
Time Elapsed 00:00:02.78
```

StringLibrary フォルダーに移動します。
```
cd StringLibrary
```
Class1.csを開き、その内容を次のコードに置き換えます。
```
namespace UtilityLibraries;

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

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

は、クラスのメンバーであるかのように呼び出すことができるように、拡張メソッドとして実装されます。
ファイルを保存し、プロジェクトをビルドします。
```
dotnet build
```
ビルドはエラーなしで成功するはずです。

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

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

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

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

using System;
using UtilityLibraries;

int row = 0;

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

    string? input = Console.ReadLine();
    if (string.IsNullOrWhiteSpace(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 キーを押すと、アプリケーションが終了し、コンソールウィンドウが閉じます。

Solution Explorer新しいプロジェクトを選択するか、コマンドパレットで .NET: 新しいプロジェクトを選択します。
[コンソールアプリ] を選択します。
ShowCase という名前を付け、既定のディレクトリを選択し、[プロジェクトの作成] を選択します。

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

using System;
using UtilityLibraries;

int row = 0;

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

    string? input = Console.ReadLine();
    if (string.IsNullOrWhiteSpace(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;
}

変更を保存。

tutorials フォルダーに戻り、新しいコンソールアプリを作成します。
```
cd ..
dotnet new console -n ShowCase
```

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

using System;
using UtilityLibraries;

int row = 0;

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

    string? input = Console.ReadLine();
    if (string.IsNullOrWhiteSpace(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;
}

変更を保存。

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

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

Solution Explorer で、ShowCase プロジェクトの Dependencies ノードを右クリックし、プロジェクト参照の追加 を選択します。
[参照マネージャー] ダイアログボックスで、[StringLibrary] プロジェクトを選び、[OK] を選びます。

Solution ExplorerShowCase プロジェクトを右クリックし、プロジェクト参照の追加を選択します。
StringLibrary を選択します。

ヒント

または、 ShowCase.csproj に次のコードを追加します。

<ItemGroup>
  <ProjectReference Include="..\StringLibrary\StringLibrary.csproj" />
</ItemGroup>

ShowCase プロジェクトから StringLibrary プロジェクトへの参照を追加します。

cd ShowCase
dotnet add reference ../StringLibrary/StringLibrary.csproj

アプリを実行する

Solution Explorer で、ShowCase プロジェクトを右クリックし、コンテキストメニューで Set as StartUp Project を選択します。
CtrlF5 押して、デバッグなしでプログラムをコンパイルして実行します。
文字列を入力してEnterキーを押すとプログラムを試すことができ、終了するにはEnterキーを押します。

上部のメニューバーを使用して、[ 実行>デバッグなしで実行] を選択します。
C#を選択します。
[C#: ShowCase] を選択します。

C# プログラムが読み込まれていないというエラーが発生した場合は、開いているフォルダーを閉じて、ShowCase フォルダーを開きます。次に、アプリをもう一度実行してみてください。

文字列を入力してEnterキーを押すとプログラムを試すことができ、終了するにはEnterキーを押します。

ターミナル出力は次の例のようになります。

Press <Enter> only to exit; otherwise, enter a string and press <Enter>:

A string that starts with an uppercase letter
Input: A string that starts with an uppercase letter
Begins with uppercase? : Yes

a string that starts with a lowercase letter
Input: a string that starts with a lowercase letter
Begins with uppercase? : No

ShowCase アプリを実行します。
```
dotnet run
```

文字列を入力してEnterキーを押すとプログラムを試すことができ、終了するにはEnterキーを押します。

ターミナル出力は次の例のようになります。

Press <Enter> only to exit; otherwise, enter a string and press <Enter>:

A string that starts with an uppercase letter
Input: A string that starts with an uppercase letter
Begins with uppercase? : Yes

a string that starts with a lowercase letter
Input: a string that starts with a lowercase letter
Begins with uppercase? : No

その他のリソース

.NET CLI を使用した開発ライブラリ
.NET Standard バージョンとサポートされるプラットフォーム。

リソースをクリーンアップする

GitHub、非アクティブ状態が 30 日後に Codespace を自動的に削除します。このシリーズのその他のチュートリアルを調べる予定がある場合は、Codespace をプロビジョニングしたままにしておくことができます。 .NET サイトにアクセスして.NET SDK をダウンロードする準備ができたら、Codespace を削除できます。 Codespace を削除するには、ブラウザーウィンドウを開き、 Codespaces に移動します。ウィンドウにコードスペースの一覧が表示されます。 learn チュートリアルのコードスペースのエントリで、3 つのドット (...) を選択します。次に、[削除] を選択します。

次のステップ

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

Unit .NET クラスライブラリをテストします

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

Visual Studio

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

.NET コンソールアプリケーションを発行します

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-03-06

チュートリアル: .NET クラス ライブラリを作成する

[前提条件]

インストール手順

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

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

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

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

アプリを実行する

その他のリソース

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

チュートリアル: .NET クラスライブラリを作成する

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

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