در این آموزش، یک پروژهٔ Windows Forms با C# می‌سازیم و ظاهر یک برنامهٔ کوچک برای «افزودن نام به فهرست» رو آماده می‌کنیم.
برنامه یک کادر ورود نام، یک دکمه و یک فهرست خواهد داشت. در این مقاله، اجزای فرم رو می‌چینیم و تنظیم می‌کنیم. در مقالهٔ بعد، کد دکمه رو می‌نویسیم و برنامه رو اجرا و اشکال‌زدایی می‌کنیم.
قبل از شروع چه چیزهایی لازم داریم؟
این آموزش بر اساس Visual Studio 2026 و .NET 10 LTS نوشته شده و برای انجام مراحل به ویندوز نیاز داریم. از نسخهٔ پایدار Visual Studio و آخرین به‌روزرسانی پایدار .NET 10 استفاده کنید.
موقع نصب Visual Studio، بخش .NET desktop development و ابزارهای مربوط به .NET 10 رو انتخاب کنید.
برای مراحل طراحی فرم، نیازی به تجربهٔ قبلی Windows Forms ندارید. برای کدنویسی مقالهٔ بعد، آشنایی مقدماتی با متغیر، شرط و متد در C# کمک می‌کنه.
کدوم قالب Windows Forms رو انتخاب کنیم؟
موقع ساخت پروژه، ممکنه این دو قالب رو ببینید:
Windows Forms App
این قالب رو برای آموزش حاضر انتخاب می‌کنیم و پروژه رو روی .NET 10 می‌سازیم.
Windows Forms App (.NET Framework)
این قالب به مسیر جداگانهٔ .NET Framework مربوطه. اگر دارید یک پروژهٔ قدیمی رو ادامه می‌دید، باید نسخه و وابستگی‌های همان پروژه رو بررسی کنید؛ لازم نیست فقط برای دنبال‌کردن این آموزش، پروژهٔ قدیمی رو تغییر بدید.
مرحلهٔ اول: ساخت پروژهٔ جدید
- Visual Studio رو باز کنید و روی Create a new project کلیک کنید.
- در کادر جست‌وجوی قالب‌ها، عبارت
winformsرو بنویسید. - فیلتر زبان رو روی C# قرار بدید.
- قالب Windows Forms App رو انتخاب کنید و روی Next کلیک کنید. برای این آموزش، قالبی که عبارت
.NET Frameworkداره انتخاب نکنید.
- در قسمت Project name، نام
Namesرو وارد کنید. - در قسمت Location، پوشهٔ ذخیره‌سازی پروژه رو مشخص کنید و روی Next کلیک کنید. لازم نیست مسیر پوشهٔ شما با تصویر یکسان باشه.
Names قرار بدید و محل ذخیره رو متناسب با پوشه‌های سیستم خودتون انتخاب کنید.- در صفحهٔ Additional information، گزینهٔ .NET 10.0 (Long Term Support) رو انتخاب کنید و روی Create کلیک کنید.
نتیجهٔ موردانتظار: پروژه ساخته می‌شه و معمولاً فرم اولیه با نام Form1 در محیط طراحی باز می‌شه.
مرحلهٔ دوم: آشنایی با بخش‌های موردنیاز
برای آماده‌کردن فرم، با چهار بخش کار داریم:
- Form Designer: محیط طراحی فرم است. کنترل‌هایی مثل دکمه و کادر متن رو روی این سطح قرار می‌دیم.
- Toolbox: فهرست کنترل‌های قابل‌استفاده است. برای نمایش اون از منوی View > Toolbox استفاده کنید.
- Properties: ویژگی‌های فرم یا کنترل انتخاب‌شده رو نشان می‌ده. از مسیر View > Properties Window بازش کنید.
- Solution Explorer: فایل‌ها و ساختار پروژه رو نشان می‌ده. اگر باز نیست، از مسیر View > Solution Explorer نمایش بدید.
اگر به‌جای فرم، کد باز شده، در Solution Explorer روی Form1.cs راست‌کلیک کنید و View Designer رو بزنید.
لازم نیست چیدمان پنجره‌های شما دقیقاً شبیه تصویر آموزش باشه؛ کافی است به این بخش‌ها دسترسی داشته باشید.
تفاوت Project و Solution چیه؟
Project شامل فایل‌ها و تنظیمات یک پروژه است. Solution برای سازمان‌دهی یک یا چند Project استفاده می‌شه. در این آموزش، فقط یک پروژه داخل Solution داریم.
مرحلهٔ سوم: تنظیم عنوان فرم
در Designer، روی قسمت خالی فرم کلیک کنید تا خود فرم انتخاب بشه.
در پنجرهٔ Properties، ویژگی Text رو پیدا کنید و مقدارش رو به «فهرست نام‌ها» تغییر بدید.
نتیجهٔ موردانتظار: عنوان بالای فرم تغییر می‌کنه.
Text با نام فایل یا نام کلاس فرم فرق داره. اینجا فقط عنوانی رو تغییر دادیم که کاربر می‌بینه؛ نام Form1 رو تغییر نمی‌دیم.
مرحلهٔ چهارم: اضافه‌کردن اجزای فرم
از Toolbox، چهار کنترل زیر رو روی فرم بکشید. برای تنظیم هر کنترل، اول روی همان کنترل کلیک کنید؛ بعد ویژگی‌هاش رو در Properties تغییر بدید.
یک Label برای راهنمای ورودی
ویژگی (Name) رو روی lblName و ویژگی Text رو روی «نام:» قرار بدید.
یک TextBox برای ورود نام
ویژگی (Name) رو روی txtName قرار بدید و مقدار ویژگی Text رو خالی نگه دارید.
یک Button برای افزودن نام
ویژگی (Name) رو روی btnAdd و ویژگی Text رو روی «افزودن نام» قرار بدید.
یک ListBox برای نمایش نام‌ها
ویژگی (Name) رو روی lstNames قرار بدید. فعلاً چیزی به مجموعهٔ Items اضافه نکنید.
مرحلهٔ پنجم: مرتب‌کردن ظاهر فرم
Label و کادر ورود نام رو کنار هم در بالای فرم قرار بدید.
دکمهٔ «افزودن نام» رو زیر کادر ورودی بذارید.
فهرست رو پایین آن‌ها قرار بدید و اندازه‌ش رو طوری تنظیم کنید که چند نام داخلش دیده بشه.
با کشیدن لبه‌های فرم و کنترل‌ها می‌تونید اندازه‌ها رو تغییر بدید. در این مرحله، خوانایی و نداشتن هم‌پوشانی بین اجزا کافیه.
نتیجهٔ موردانتظار: ظاهر برنامه آماده است، اما دکمه هنوز کدی برای افزودن نام نداره.
مرحلهٔ ششم: ذخیره‌کردن پروژه
از منوی File > Save All استفاده کنید.
قبل از ادامه بررسی کنید که عنوان فرم «فهرست نام‌ها» باشه، کادر ورودی و فهرست خالی باشن و نام کنترل‌ها دقیقاً مطابق مراحل قبل تنظیم شده باشه.
تمرین کوتاه
بدون تغییر نام کنترل‌ها، متن دکمه رو به «ثبت نام در فهرست» تغییر بدید.
اندازهٔ فهرست رو بزرگ‌تر کنید و دوباره پروژه رو ذخیره کنید.
هدف این تمرین، شناخت تفاوت نام کنترل در کد و متن قابل‌نمایش اون برای کاربره.
خطاهای رایج این مرحله
قالب Windows Forms App پیدا نمی‌شه
فیلترهای جست‌وجوی قالب رو بررسی کنید. اگر قالب همچنان وجود نداره، در Visual Studio Installer مطمئن بشید بخش .NET desktop development نصب شده.
گزینهٔ .NET 10 نمایش داده نمی‌شه
ابتدا بررسی کنید قالب .NET Framework رو انتخاب نکرده باشید. سپس نصب ابزارهای .NET 10 و به‌روز بودن Visual Studio رو بررسی کنید.
به‌جای فرم، کد نمایش داده می‌شه
روی Form1.cs در Solution Explorer راست‌کلیک کنید و View Designer رو انتخاب کنید.
به‌جای نام کنترل، نوشتهٔ روی دکمه تغییر کرده
برای نامی که در کد استفاده می‌شه، ویژگی (Name) رو تغییر بدید. ویژگی Text نوشتهٔ قابل‌نمایش روی دکمه است.
قدم بعدی
پروژه و ظاهر فرم آماده شده. برای آشنایی با اجرای فرم، مقالهٔ مراحل اجرای برنامه در C# رو بخونید. در ادامهٔ این مجموعه، کد افزودن نام به فهرست و تفاوت اجرای عادی با اجرای همراه دیباگر رو هم یاد می‌گیریم.
اگر می‌خوای یادگیری C# رو ادامه بدی
اگر مبانی برنامه‌نویسی رو بلدی و می‌خوای C#، شی‌گرایی، کار با مجموعه‌ها و Debug مقدماتی رو در مسیر ساخت بک‌اند و Web API دنبال کنی، سرفصل‌های دورهٔ C# و ASP.NET Core پروژه‌محور رو بررسی کن. برای بخش وب دوره، آشنایی مقدماتی با HTML و CSS هم لازمه.
تمرکز این دوره بر یادگیری C# و توسعهٔ بک‌اند وب است.