C# Academy · レッスン

開発者体験と制限事項

ジェネレーターが開発者体験に与える影響を確認します。命名、ファイル検出、診断、ビルド性能、安全なフォールバックをC# 6でのエミュレーションとともに扱います。

「開発者体験と制限事項」はCoddyKit上の無料C# Academyレッスンです。これはレッスン2/2です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはC# Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 C# Academyコースには全2レッスンが含まれています。

DXと制限の概要

目的: 生成されたコードを使いやすくします。

予測可能な名前とファイルの場所
役立つ診断情報
小さく、目的を絞った出力
制限を把握する: ビルド時のみで、実行時リフレクションはありません

予測可能な名前

安定した名前（例: *.g.cs、DebugId）を使用すると、ユーザーが生成されたメンバーをすぐに見つけられます。

using System;

// Emulate "predictable" generated naming: suffixes and folders are consistent.
public partial class Order
{
  public int Id;
}

// Simulated generated piece: same partial name, with a clear suffix convention.
public partial class Order // would live in Order.g.cs typically
{
  public string DebugId()
  {
    // predictable member name makes discovery easy
    return "Order#" + Id;
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    Order o = new Order();
    o.Id = 42;
    Console.WriteLine(o.DebugId());
  }
}

衝突の回避

専用の名前空間（例: Generated.*）と明確なプレフィックスを使うと、ユーザーコードとの衝突を避けられます。

using System;

namespace Generated
{
  // Emulate a generator using a dedicated namespace to reduce collisions
  public static class OrderExtensions
  {
    public static string ToLabel(this Order o) { return "Order: " + o.Id; }
  }
}

public partial class Order { public int Id; }

public class Program
{
  public static void Main(string[] args)
  {
    Order o = new Order();
    o.Id = 7;
    // Extension lives under Generated.* to stay out of the way
    Console.WriteLine(Generated.OrderExtensions.ToLabel(o));
  }
}

役立つ診断情報

優れたジェネレーターは、入力が無効な場合に明確な診断情報を出力するため、ユーザーはすぐにコードを修正できます。

using System;

// Emulate generator diagnostics: validate inputs and print clear messages.
public static class GenCheck
{
  public static string EmitGetter(string fieldName)
  {
    if (string.IsNullOrEmpty(fieldName))
      return "DIAGNOSTIC: Field name is empty. Skipping emission.";
    if (!char.IsLetter(fieldName[0]))
      return "DIAGNOSTIC: Field must start with a letter: " + fieldName;

    // pretend emission was fine
    return "OK: Generated getter for " + fieldName;
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    Console.WriteLine(GenCheck.EmitGetter("1bad")); // diagnostic
    Console.WriteLine(GenCheck.EmitGetter("name")); // ok
  }
}

小さく目的を絞った出力

1 つの責務を持つ小さな生成ファイルを優先します。読みやすく、デバッグもしやすくなります。

using System;

// Emulate small, single-purpose emissions instead of huge files.
public partial class Report
{
  public int Count;
}

public partial class Report // Report.Stats.g.cs idea
{
  public double Average(int total)
  {
    if (Count == 0) return 0.0;
    return (double)total / Count;
  }
}

public partial class Report // Report.Format.g.cs idea
{
  public string Summary(int total)
  {
    return "Total=" + total + ", Count=" + Count + ", Avg=" + Average(total);
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    Report r = new Report();
    r.Count = 4;
    Console.WriteLine(r.Summary(20));
  }
}

制限とフォールバック

制限:

ビルド時に実行され、実行時には実行されません。
負荷の大きい I/O やネットワーク呼び出しは避けます。
ジェネレーターの処理経路内で実行時リフレクションに依存しないでください。
出力は決定的に保ちます。

フォールバック: 入力が無効な場合は、ビルド全体を失敗させるのではなく、診断情報または最小限のスタブを出力します。

DXのベストプラクティス

確認問題: ソースジェネレーターを使用する際、開発者体験を向上させるプラクティスはどれですか。

まとめ

まとめ: 予測可能な名前、明確な診断情報、小さな出力を優先します。ビルド時の制限を守り、入力が無効な場合は安全なフォールバックを提供します。

よくある質問

「開発者体験と制限事項」レッスンは無料ですか？

はい。「開発者体験と制限事項」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、C# Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 C# Academyコースには全2レッスンが含まれています。

「開発者体験と制限事項」で何を学びますか？

ジェネレーターが開発者体験に与える影響を確認します。命名、ファイル検出、診断、ビルド性能、安全なフォールバックをC# 6でのエミュレーションとともに扱います。ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

C# Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのC# Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン2/2です。

「開発者体験と制限事項」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このC# Academyレッスンでコードを書いて実行できますか？

はい。すべてのC# Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

概念とユースケース、インクリメンタルジェネレーター（概要）
開発者体験と制限事項

← C# Academyに戻る