</>مدرسه زیب‌موجیاد بگیر، تمرین کن، بساز
مدرسهC#درس 21
درس 21 از 21 · ۴۰ دقیقه

پروژه؛ ASP.NET Core Task API

یک مسئله واقعی را با «پروژه؛ ASP.NET Core Task API» حل می‌کنیم و نتیجه را همان لحظه می‌بینیم.

۰امتیاز شما
نقشه این درس

بعد از این درس چه کاری می‌توانی انجام بدهی؟

  • پروژه نهایی record، DI، service، repository، JSON/EF، async، validation، ProblemDetails و xUnit را وصل می‌کند.
  • کد را اجرا و نتیجه را پیش‌بینی کنی
  • یک تغییر کوچک بدهی و اثرش را توضیح بدهی
  • خطای واقعی درس را بخوانی و برطرف کنی
نکته مهم برای شروع C#

اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیک‌ترین سرنخ‌اند.

چرا مهم است؟ پروژه نهایی record، DI، service، repository، JSON/EF، async، validation، ProblemDetails و xUnit را وصل می‌کند.

اولین تمرین تو: WebApplicationFactory، migration و shutdown را کامل کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.

توضیح ساده و قدم‌به‌قدم

از یک مثال کوچک شروع کن

پروژه نهایی record، DI، service، repository، JSON/EF، async، validation، ProblemDetails و xUnit را وصل می‌کند. کد زیر را در فایل «Program.cs» خودت تایپ و اجرا کن. بعد خروجی را با انتظار درس مقایسه کن.

1

۱. نمونه را اجرا کن

پیش از اجرا خروجی را حدس بزن و سپس تفاوت را یادداشت کن.

2

۲. کد را تغییر بده

WebApplicationFactory، migration و shutdown را کامل کن.

3

۳. خطا را عمداً بساز

گرفتن owner یا status از body بدون قانون دامنه دستکاری داده را ممکن می‌کند. متن خطا و شماره خط را بخوان، علت را پیدا کن و فقط همان بخش را اصلاح کن.

نکته مهم

اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیک‌ترین سرنخ‌اند.

مفهوم‌های اصلی

سه قطعه‌ای که باید بفهمی

پروژه؛ ASP.NET Core Task API

پروژه نهایی record، DI، service، repository، JSON/EF، async، validation، ProblemDetails و xUnit را وصل می‌کند.

نتیجه قابل مشاهده

عنوان معتبر 201، بد 400 و شناسه ناموجود 404 می‌گیرد؛ cancellation تا repository می‌رسد.

خطایی که باید بشناسی

گرفتن owner یا status از body بدون قانون دامنه دستکاری داده را ممکن می‌کند.

سناریوی واقعی

API باید create، list، complete، persistence و تست integration داشته باشد.

فرض کن API باید create، list، complete، persistence و تست integration داشته باشد. فعلاً قرار نیست کل برنامه را بسازیم؛ فقط همین نیاز را با چند خط کد حل می‌کنیم تا معلوم باشد هر خط چه کاری انجام می‌دهد.

کارگاه تعاملی

بررسی ساختار تمرین

این صفحه کامپایلر کامل C# نیست؛ ساختار تمرین را صادقانه بررسی می‌کند و خروجی مورد انتظار را نشان می‌دهد. برای اجرای کامل به محیط رسمی همان زبان نیاز است.

Program.cs
خروجیآماده
یک بخش را تغییر بده و دکمه بررسی را بزن.
بعد از هر تغییر، نتیجه را دوباره بررسی کن.
تمرین هدایت‌شده

WebApplicationFactory، migration و shutdown را کامل کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.

دام‌های رایج

این سه اشتباه را انجام نده

1

گرفتن owner یا status از body بدون قانون دامنه دستکاری داده را ممکن می‌کند.

2

کپی‌کردن کد بدون اجرای مرحله‌به‌مرحله

3

تغییر چند قسمت هم‌زمان و گم‌شدن علت نتیجه

سنجش چندمرحله‌ای

با 5 سؤال مطمئن شو که مفهوم را گرفته‌ای

سؤال 1 از 5

خروجی درست این نمونه چیست؟

سؤال 2 از 5

چرا پیش از اجرا نتیجه را حدس می‌زنیم؟

سؤال 3 از 5

سرنخ خطای این درس چیست؟

سؤال 4 از 5

بعد از تغییر کد چه کنیم؟

سؤال 5 از 5

چه وقت آماده درس بعدی هستی؟

پایان درس 21

فهمیدی، تغییر دادی، نتیجه را توضیح دادی؟

فقط در این صورت درس را کامل کن و سراغ مرحله بعد برو.