آموزش کامل رکورد کلاسی record class در C# و .NET
مقدمه
رکورد کلاسی record class یکی از اجزای مهم ساختار برنامه در C# است. ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی. این مقاله از تعریف پایه شروع میکند و سپس syntax، رفتار compiler، سناریوهای واقعی، خطاها، کارایی و بهترین روشها را با مثالهای مستقل بررسی میکند.
برای دیدن جایگاه این موضوع در کنار سایر اجزای زبان، راهنمای جامع ساختار برنامه در C# را نیز مطالعه کنید.
تعریف، Syntax، پارامترها و خروجی
تعریف عملی record class باید بر اساس semantics زبان فهمیده شود. هدف اصلی آن ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی است. در بسیاری از موارد این قابلیت پارامتر کلاسیک مانند یک متد ندارد؛ در عوض اجزای نحوی، modifierها، نوعهای درگیر و قواعد scope نقش پارامترهای طراحی را بازی میکنند.
Syntax پایه
public record class Customer(int Id, string Name);
خروجی این ساختار معمولاً یک مقدار مستقل مانند خروجی تابع نیست؛ نتیجه آن در شکل نوع تولیدشده، metadata، رفتار دسترسی، نقطه ورود، فرآیند مقداردهی یا نحوه اجرای برنامه دیده میشود. به همین دلیل باید اثر compile-time و runtime را جداگانه بررسی کرد.
تصویر 1: نقشه مفهومی record class؛ ارتباط میان record class، reference semantics، value equality، with، inheritance را در یک نمای فنی نشان میدهد.
نکات فنی و طراحی
در طراحی نرمافزار حرفهای، انتخاب ساختار زبانی فقط یک تصمیم نحوی نیست؛ این انتخاب روی خوانایی، قابلیت آزمون، مرزهای وابستگی، هزینه نگهداری و امکان توسعه آینده اثر مستقیم دارد. درباره record class باید هم رفتار کامپایلر را شناخت و هم پیامد آن را در معماری پروژه سنجید. استفاده درست زمانی شکل میگیرد که هدف نوع یا عضو، سطح دسترسی، طول عمر داده و الگوی مصرف آن از ابتدا روشن باشد.
record class در پروژههای واقعی معمولاً همراه با چند مفهوم دیگر استفاده میشود و نباید آن را جدا از قراردادهای کدنویسی تیم دید. نامگذاری دقیق، کوچک نگه داشتن مسئولیتها، مستندسازی دلیل تصمیم و نوشتن تست برای رفتارهای حساس باعث میشود این قابلیت به جای ایجاد پیچیدگی، ساختار کد را شفافتر کند. هنگام بازبینی کد نیز باید بررسی شود که آیا سادهترین ابزار مناسب انتخاب شده است یا نه.
از دید کارایی، هزینه اصلی همیشه در خود keyword یا syntax نیست؛ الگوی تخصیص حافظه، boxing، reflection، virtual dispatch، initialization، lifetime و تعداد دفعات اجرا میتواند نتیجه را تغییر دهد. بنابراین هر ادعای performance باید با benchmark و سناریوی واقعی سنجیده شود. بهینهسازی زودهنگام بدون اندازهگیری معمولاً ارزش کمتری از طراحی روشن و قابل نگهداری دارد.
از دید سازگاری نسخهها، بعضی قابلیتهای C# در نسخههای جدید زبان اضافه شدهاند و ممکن است به تنظیم LangVersion یا نسخه جدیدتر SDK نیاز داشته باشند. تیم باید target framework و نسخه compiler را در CI ثابت و مستند کند. این کار از تفاوت رفتار محیط توسعه و build server جلوگیری میکند و مهاجرت بین نسخهها را قابل پیشبینیتر میسازد.
یکی از خطاهای رایج درباره record class استفاده از آن فقط برای کوتاهتر کردن کد است، بدون توجه به semantics. کوتاهی متن همیشه به معنی سادگی مدل نیست. بهترین روش این است که ابتدا invariant و قرارداد رفتاری مشخص شود، سپس ساختار زبانی انتخاب شود و در نهایت با تست واحد، تحلیل nullable و هشدارهای compiler صحت تصمیم کنترل گردد.
تصویر 2: جریان اجرا record class؛ ارتباط میان record class، reference semantics، value equality، with، inheritance را در یک نمای فنی نشان میدهد.
مثالهای عملی
مثال 1: مثال پایه با مقدار ثابت
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(1,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 1 | 1:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 2: کار با داده نمونه
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(2,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 2 | 2:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 3: استفاده در جریان پردازش
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(3,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 3 | 3:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 4: استفاده در شرط یا اعتبارسنجی
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(4,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 4 | 4:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 5: ترکیب با قابلیت دیگر C#
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(5,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 5 | 5:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 6: رفتار با مقدار تهی یا حالت نامعتبر
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(6,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 6 | 6:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 7: حالت مرزی و داده غیرمعمول
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(7,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 7 | 7:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 8: سناریوی سازمانی و گزارشگیری
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(8,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 8 | 8:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 9: روش اشتباه و نسخه اصلاحشده
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(9,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 9 | 9:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
مثال 10: سناریوی کارایی و بهینهسازی
در این سناریو، record class برای نمایش ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی به کار میرود. هدف مثال این است که رفتار اصلی را در یک برنامه کوچک و قابل بررسی ببینیم و سپس همان ایده را در پروژه واقعی توسعه دهیم.
public record class Person(int Id,string Name);
public static class Program { public static void Main() { var p=new Person(10,"Ali"); var p2=p with { Name="Sara" }; Console.WriteLine($"{p.Id}:{p2.Name}"); } }
| بخش | نتیجه نمونه | نکته |
|---|
| مثال 10 | 10:Sara | خروجی نمایشی برای درک رفتار بدون نیاز به اجرای فوری |
کاربرد واقعی این مثال در طراحی سرویس، مدل دامنه یا کد زیرساختی است. هنگام استفاده از record class باید محدودیت نسخه زبان و semantics دقیق قابلیت را نیز بررسی کرد.
خطاهای رایج، Performance و Best Practices
در پروژههای سازمانی، record class باید در کنار dependency injection، logging، validation، exception handling و سیاستهای امنیتی دیده شود. ساختار مناسب کمک میکند مسئولیت هر بخش روشن بماند و تغییر یک قسمت، دامنه اثر محدودتری داشته باشد. همچنین code review زمانی مؤثرتر است که تیم برای استفاده از این قابلیت قواعد مشترک و مثالهای مرجع داشته باشد.
برای آموزش record class بهتر است از یک مثال کوچک شروع کرد و سپس همان مثال را به سناریوی واقعی گسترش داد. مشاهده خروجی نمونه اهمیت زیادی دارد، زیرا توسعهدهنده بدون اجرای کد نیز میتواند رابطه میان ورودی، پردازش و نتیجه را درک کند. مثال خوب باید نشان دهد چه زمانی این قابلیت مناسب است و چه زمانی جایگزین سادهتری انتخاب بهتری خواهد بود.
در طراحی API عمومی با record class باید به backward compatibility توجه ویژه داشت. تغییری که در کد داخلی بیخطر به نظر میرسد ممکن است برای مصرفکننده کتابخانه breaking change باشد. سطح دسترسی، امضای اعضا، قرارداد serialization و رفتار reflection باید قبل از انتشار نسخه جدید بررسی شوند تا ارتقا برای کاربران قابل مدیریت باقی بماند.
همچنین ابزارهای تحلیل ایستا و IDE میتوانند بسیاری از مشکلات مرتبط با record class را زودتر آشکار کنند. فعال بودن nullable reference types، analyzers و warning-as-error در بخشهای حساس کیفیت را بالا میبرد. با این حال ابزار جایگزین فهم semantics نیست؛ توسعهدهنده باید بداند compiler چه چیزی تولید میکند و runtime چگونه آن را اجرا میکند.
جمعبندی عملی این است که record class زمانی ارزشمند است که نیت طراحی را واضحتر کند. هرجا این قابلیت فقط پیچیدگی پنهان، coupling یا رفتار غیرمنتظره ایجاد کند باید دوباره تصمیم را بررسی کرد. کد خوب علاوه بر درست کار کردن، برای عضو بعدی تیم قابل فهم است و مسیر تغییر آینده را نیز ساده نگه میدارد.
تصویر 3: سناریوی عملی و بهترین روش record class؛ ارتباط میان record class، reference semantics، value equality، with، inheritance را در یک نمای فنی نشان میدهد.
سؤالات متداول
record class در C# دقیقاً چه مسئلهای را حل میکند؟
record class یک ابزار زبانی برای بیان روشنتر ساختار و قرارداد کد است. کاربرد دقیق آن به semantics همان قابلیت وابسته است و باید در کنار طراحی نوع، سطح دسترسی و نیاز واقعی پروژه بررسی شود.
برای شروع یادگیری record class چه پیشنیازهایی لازم است؟
آشنایی با syntax پایه C#، نوعها، scope و فرآیند build کافی است. سپس بهتر است record class با مثال کوچک، خروجی قابل مشاهده و یک سناریوی واقعی تمرین شود.
آیا استفاده از record class هزینه توسعه پروژه تجاری را کاهش میدهد؟
در صورت استفاده درست میتواند هزینه نگهداری و خطا را کم کند، اما انتخاب اشتباه record class پیچیدگی ایجاد میکند. ارزش اقتصادی آن از کاهش دوبارهکاری، خوانایی بهتر و توسعه امنتر حاصل میشود.
در پروژههای سازمانی چه زمانی سرمایهگذاری روی طراحی درست record class ارزشمند است؟
وقتی کد طول عمر زیاد، چند توسعهدهنده یا API عمومی دارد، تصمیم طراحی درباره record class اهمیت بیشتری پیدا میکند. مستندسازی و code review در چنین پروژههایی ضروری است.
record class با نزدیکترین گزینه جایگزین چه تفاوتی دارد؟
تفاوت اصلی در semantics، سطح دسترسی، مدل حافظه یا نحوه تعامل compiler و runtime است. مقایسه باید بر اساس نیاز دامنه انجام شود، نه صرفاً کوتاهی syntax.
برای مشاوره یا انجام پروژهای که از record class استفاده میکند چه اطلاعاتی باید آماده شود؟
برای مشاوره بهتر است target framework، نسخه C#، ساختار solution، محدودیتهای deployment و نمونه کد فعلی مشخص باشد. این اطلاعات انتخاب الگوی مناسب و برآورد دقیقتر را ممکن میکند.
رایجترین خطای توسعهدهندگان هنگام استفاده از record class چیست؟
خطای رایج، استفاده از record class بدون فهم محدوده اثر آن است. فعال کردن analyzerها، نوشتن تست و بررسی warningهای compiler بسیاری از مشکلات را زود آشکار میکند.
record class چه اثری بر Performance دارد؟
اثر performance به سناریو وابسته است. allocation، dispatch، boxing، reflection یا initialization میتوانند مهم باشند؛ بنابراین benchmark واقعی از حدس بهتر است.
بهترین روش عملی برای استفاده امن از record class چیست؟
اصل کلیدی این است که record class نیت طراحی را واضح کند، مسئولیتها کوچک بمانند و قراردادها با تست محافظت شوند. از پیچیدگی غیرضروری و API عمومی شکننده پرهیز شود.
record class با کدام نسخههای C# و .NET سازگار است؟
سازگاری به قابلیت دقیق زبان وابسته است. برای ویژگیهای جدید باید نسخه SDK و LangVersion بررسی شود و در CI همان نسخه compiler تثبیت گردد.
سؤالات مصاحبه
- record class چه semantics اصلی دارد و compiler چگونه آن را تفسیر میکند؟
- چه زمانی استفاده از record class نسبت به گزینه جایگزین مناسبتر است؟
- یک خطای رایج در طراحی record class را توضیح دهید و راه اصلاح آن چیست؟
- تأثیر احتمالی record class بر حافظه، runtime یا API عمومی چیست؟
- چگونه سازگاری نسخهای record class را در CI کنترل میکنید؟
چکلیست نهایی
- هدف استفاده از record class روشن و مستند است.
- سطح دسترسی و scope بررسی شده است.
- نسخه C# و target framework سازگار است.
- هشدارهای compiler و analyzer بررسی شدهاند.
- مثال و تست برای رفتارهای مرزی وجود دارد.
- ادعای performance با اندازهگیری پشتیبانی میشود.
جمعبندی
رکورد کلاسی record class زمانی بهترین نتیجه را میدهد که برای بیان واضح نیت طراحی استفاده شود. ترکیب رفتار نوع مرجع با امکانات record و برابری ارزشی. با شناخت دقیق semantics، کنترل نسخه زبان، تست و code review میتوان از این قابلیت در پروژههای کوچک تا سامانههای سازمانی با اطمینان استفاده کرد.
برای مرور تمام اجزای مرتبط، به مقاله مادر ساختار برنامه در C# بازگردید.