【C#】 プロパティ 使い方をわかりやすく解説

※ この記事にはアフィリエイトリンクが含まれます

C#のプロパティの使い方で悩んでいませんか?

・フィールドとの違いがよく分からない、どちらを使うべきか迷うことはありませんか?

・ゲッターやセッターで値の検証や処理を書くときの書き方が分からず詰まることはありませんか?

・自動プロパティ、読み取り専用、初期化専用(init)などの使い分けが分からないことはありませんか?

結論から言うと、C#のプロパティは「データの隠蔽と操作の入り口」を簡潔に実現する仕組みで、使い方を理解すればコードが分かりやすく、安全になります。

・基本的な定義(自動プロパティ・フルプロパティ)を学ぶ

・実務でよく使うパターン(バリデーション、読み書き制御、計算プロパティ)を身につける

・最新機能(initアクセサ、式形式プロパティ)を覚えて可読性を上げる

この記事では、C# プロパティ 使い方を初心者向けに、基礎から実践例まで丁寧に解説します。

目次

C#のプロパティとは何か

プロパティはクラスの外部からアクセスするデータの公開方法です。

フィールドを直接公開する代わりに、プロパティを使うことで読み書き時に処理を挟めます。

なぜプロパティを使うのか(理由と利点)

プロパティを使う主な理由は、カプセル化と将来の拡張性です。

最初は単純な値の公開でも、後から検証や通知、ログを追加したい場合に
フィールドからプロパティへ置き換える必要がありません。

基本的なプロパティの書き方

まずは最も簡単な自動実装プロパティから見ていきましょう。

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

この例ではコンパイラが裏で自動的にフィールドを作り、
NameAgeの読み書きを扱います。

次に、カスタム処理が必要な場合はバックフィールドを使ったフルプロパティを使います。

public class Person
{
    private int _age;

    public int Age
    {
        get { return _age; }
        set
        {
            if (value < 0) throw new ArgumentOutOfRangeException(nameof(value));
            _age = value;
        }
    }
}

このパターンでは、セッターで値の検証を行い、不正な値を防げます。

読み取り専用プロパティと初期化専用(init)

読み取り専用にしたい場合はgetのみを定義します。

public string Id { get; } = Guid.NewGuid().ToString();

C# 9以降ではinitアクセサが使えます。オブジェクト初期化時のみ設定可能で、
不変オブジェクトの作成に便利です。

public class Config
{
    public string Host { get; init; }
    public int Port { get; init; }
}

var cfg = new Config { Host = "localhost", Port = 8080 };
// cfg.Port = 80; // コンパイルエラー

使い方の具体例とパターン

プロパティはさまざまな目的で使われます。代表的なパターンを紹介します。

1. 値の検証を行う(setterで検証)

セッターで範囲チェックや形式チェックを行うことで、クラス内部の状態を常に正しく保てます。

private string _email;
public string Email
{
    get => _email;
    set
    {
        if (string.IsNullOrWhiteSpace(value))
            throw new ArgumentException("Emailは必須です。");
        if (!value.Contains("@"))
            throw new ArgumentException("正しいEmail形式ではありません。");
        _email = value;
    }
}

このようにしておくと、外部から不正な値が入るのを防げます。

2. 計算プロパティ(読み取り専用で値を計算)

プロパティは内部データから派生値を返すのにも便利です。

public class Rectangle
{
    public double Width { get; set; }
    public double Height { get; set; }
    public double Area => Width * Height; // 式形式プロパティ
}

値を外部で保持する必要がなく、常に最新の計算結果を返します。

3. アクセス制御(private set 等)

外部からは読み取れるが書き換えさせたくない場合、セッターをprivateにします。

public DateTime CreatedAt { get; private set; } = DateTime.UtcNow;

これによりインスタンス生成後の改変を防げます。

よくある間違いと対処法

初心者がよくハマるポイントと、その解決策を提示します。

フィールドをpublicにする

publicなフィールドは簡便に見えますが、将来の拡張で困ります。
最初からプロパティを使っておくのが無難です。

例: public int age; → public int Age { get; set; }

プロパティで重い処理をする

ゲッターやセッターでDBアクセスや長い処理を行うと予期せぬ副作用が出ます。
プロパティには軽い処理だけに留め、重い処理は明示的なメソッドに分けましょう。

同期・スレッド安全性の無視

マルチスレッド環境ではプロパティの読み書きも競合します。
必要ならロックや不変オブジェクトを使って安全を確保してください。

実践的な例:クラス設計でのプロパティ活用

ここではユーザー管理クラスを例に、実務での使い方を示します。

public class User
{
    public string Username { get; init; }
    public string DisplayName { get; set; }

    private string _passwordHash;
    public void SetPassword(string password)
    {
        // ハッシュ化して内部フィールドに保存
        _passwordHash = Hash(password);
    }

    public bool VerifyPassword(string password)
    {
        return _passwordHash == Hash(password);
    }

    private string Hash(string input) => /* ハッシュ処理 */ input; 
}

ここではパスワードをプロパティで直接公開せず、メソッドで扱うことで安全にしています。
Usernameinitにして、生成後の変更を防いでいます。

ベストプラクティスと注意点

最後に実際のプロジェクトで役立つポイントをまとめます。

  • まずは自動プロパティを使い、必要ならフルプロパティへ変える。
  • プロパティは副作用を小さくし、重い処理はメソッドに移す。
  • アクセス修飾子(private setなど)で不正な変更を防ぐ。
  • 読み取り専用やinitで不変性を高める。
  • シリアライズやバインディングを意識して命名と型を設計する。

まとめ

C# プロパティ 使い方のポイントは、データの公開方法を制御し、将来の変更に強い設計をすることです。

自動プロパティ、フルプロパティ、init、式形式などを状況に応じて使い分ければ、可読性と安全性が高まります。

この記事を参考に、まずは小さなクラスからプロパティを意識して書いてみてください。
慣れることで保守性の高いコードが書けるようになります。

さらに学びたい場合は、プロパティとイベント、INotifyPropertyChangedの連携や
レコード型でのプロパティの使い方を次のステップとしておすすめします。

#エンジニアとして、もっと自分の力を活かしたいあなたへ

「このまま今の職場にいて、成長できるんだろうか?」

C#を使っている方なら、一度はそう感じたことがあるかもしれません。

実は今、C#/.NETエンジニアの市場価値は高まっており
年収アップ・フルリモート・自社開発企業など、選べる選択肢は確実に増えています。

もし今後、C#を活かして働きたい、あるいは開発現場で経験を積みたいとお考えなら…
自分に合った転職サービスを早めに知っておくことが大きな武器になります。

現役エンジニアからのサポート付き・無料で学べるスクール・社内SE特化の求人など、
転職支援サービスを厳選したまとめ記事をこちらで紹介しています。

ここまで読んでいただきありがとうございました。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

沖縄出身のエンジニアです。IT業界で5年以上の経験があり、主にC#やPHPを使って開発を行ってきました。新しい技術にも興味があり、日々学びながらスキルアップを目指しています。

コメント

コメントする

CAPTCHA


目次