オブジェクトを返すメソッドとは？

2025年7月24日

C# プログラミングでは、クラスとインスタンスを使ったオブジェクト指向が基本です。その一例として「銀行口座（BankAccount）」クラスをサンプルに用います。口座の生成や預金といった身近な操作を例にすることで、オブジェクト返却メソッドの仕組みを直感的に理解できるようになります。

なぜ「銀行口座」をサンプルにするのか？

1. 身近でイメージしやすいお金の預け入れ・残高照会は、日常的によく行われる操作です。初心者にもなじみがあるため、コードの動作を頭の中でシミュレーションしやすくなります。
2. 属性と振る舞いがわかりやすい
   • 属性: 口座名義（Owner）、残高（balance）
   • 振る舞い: 預金（Deposit）、残高取得（GetBalance）オブジェクト指向の概念を学ぶ際に、クラスのプロパティやメソッドを明確に意識できます。
3. 拡張例が豊富将来的には、引き出し機能や利息計算、口座履歴の記録など、さまざまな機能追加パターンを学習できます。

バージョン1：シンプルな口座生成

using System;

namespace ObjectReturnPattern
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 単一の口座を生成し、預金して出力
            BankAccount bankAccount = new BankAccount();
            bankAccount.Owner = "山田太郎";
            bankAccount.Deposit(1000);

            Console.WriteLine($"Owner: {bankAccount.Owner}, Balance: {bankAccount.GetBalance()}");
            // → Owner: 山田太郎, Balance: 1000
        }
    }

    public class BankAccount
    {
        public string Owner { get; set; } = "";
        private int balance = 0;

        public void Deposit(int amount)
        {
            balance += amount;
        }

        public int GetBalance()
        {
            return balance;
        }
    }
}

ポイント

• Main 内で直接 new BankAccount() を行い、操作を実装。
• サンプルとして最小限のコード。

ここで、バージョン管理の学習の基礎を見ていきます

GitHub Desktop と Visual Studio で始める段階的更新ガイド

はじめに Gitとは、ソースコードやファイルの変更履歴を記録し、複数人での共同開発を容易にする分散型 ...

 https://soft-rime.com/post-24507/

バージョン2：日本語表示＋コメント追加＆複数口座対応

using System;

namespace ObjectReturnPattern
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 1人目の口座を生成
            BankAccount account1 = new BankAccount();
            account1.Owner = "山田太郎";
            account1.Deposit(1000);

            // 2人目の口座を生成
            BankAccount account2 = new BankAccount();
            account2.Owner = "鈴木花子";
            account2.Deposit(5000);

            // 各口座の情報を日本語で表示
            Console.WriteLine($"口座名義: {account1.Owner}、残高: {account1.GetBalance()} 円");
            Console.WriteLine($"口座名義: {account2.Owner}、残高: {account2.GetBalance()} 円");
        }
    }

    /// <summary>
    /// 銀行口座を表すクラス
    /// </summary>
    public class BankAccount
    {
        // 口座名義を保持するプロパティ
        public string Owner { get; set; } = "";

        // 残高を保持する非公開フィールド
        private int balance = 0;

        /// <summary>
        /// 指定した金額を預金する
        /// </summary>
        public void Deposit(int amount)
        {
            balance += amount;
        }

        /// <summary>
        /// 現在の残高を取得する
        /// </summary>
        public int GetBalance()
        {
            return balance;
        }
    }
}

改善点

• 日本語コメントと XML ドキュメントで可読性向上。
• 複数口座に対応し、サンプルの汎用性アップ。

バージョン3：オブジェクトを返すメソッド化（ファクトリメソッド導入）

using System;

namespace ObjectReturnPattern
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // メソッドで口座生成～初期預金まで一括処理
            BankAccount account1 = CreateBankAccount("山田太郎", 1000);
            BankAccount account2 = CreateBankAccount("鈴木花子", 5000);

            Console.WriteLine($"口座名義: {account1.Owner}、残高: {account1.GetBalance()} 円");
            Console.WriteLine($"口座名義: {account2.Owner}、残高: {account2.GetBalance()} 円");
        }

        /// <summary>
        /// 銀行口座を生成し、初期預金まで完了したインスタンスを返すファクトリメソッド
        /// </summary>
        static BankAccount CreateBankAccount(string owner, int initialDeposit)
        {
            BankAccount account = new BankAccount();  // インスタンス生成
            account.Owner = owner;                   // オーナー名設定
            account.Deposit(initialDeposit);         // 初期預金
            return account;                          // 完成オブジェクトを返却
        }
    }

    /// <summary>
    /// 銀行口座を表すクラス
    /// </summary>
    public class BankAccount
    {
        public string Owner { get; set; } = "";
        private int balance = 0;

        public void Deposit(int amount) => balance += amount;
        public int GetBalance() => balance;
    }
}

// ブロック式
public void Deposit(int amount)
{
    balance += amount;
}

// 式本体メンバー（C#6.0+）
public void Deposit(int amount) => balance += amount;

大きな改善点

• 初期化ロジックを CreateBankAccount に集約し、一元管理。
• Main メソッドはシンプルかつ読みやすく。

まとめ：サンプルから学ぶオブジェクト返却メソッド

1. 身近な銀行口座 を例にすることで、属性と振る舞いを明確にイメージできる。
2. 段階的リファクタリング により、コードの再利用性・可読性・保守性が向上。
3. プロジェクトでは、このパターンをユーザー生成やリソース管理など、さまざまな場面で活用可能。

ぜひ銀行口座サンプルを足がかりに、独自クラスのファクトリメソッドやオブジェクト返却メソッドを実装してみてください！