TOC

This article is currently in the process of being translated into Arabic (~99% done).

UserControls:

Creating a UserControl

حسناً, الآن سنقوم بتشكيل و إبداع "إعدادات المستخدم" للإستدعاء و عرض لائحة معلومات عن مستخدم في مجمتمع عبر الإنترنت (أونلاين). أولاً نقوم بإضافة نافذة "إعدادات مستخدم" إلى المشروع. من خلال النقر بزر الفأره(mouse) اليمين على مربع إسم المشروع (project)الواقع في النافذة اليمينية لبرنامج البرمجة "Visual Studio" و مثمّة إختيار إضافة موضوع جديد (Add new Item) من لائحة الإختيارات الظاهرة. الخطوة التالة هي بعدما تم عرض نافذة للإضافة أنواع متعددة من ملفات التعليمات البرمجيه (code), يجب عليك إختيار "متحكم لمستخدم إنترنت" (Web User Control) من للإحة ملفات التعليمات البرمجيه الظاهرة.الخطوة الثالثة نقوم بتسمية المادة الجديدة "إعدادات المستخدم" الإسم "UserInfoBoxControl" بللإضافة كذلك لتسمية الملف كلسابق "UserInfoBoxControl.ascx". كن متأكد من إضافة خانة الاختيار (Checkbox✅) التلي تقوم بفصل ملف التعليمات البرمجيه(code) وتخزينه بملفٍّ آخر.

بعدما قمنى بتشكيل و تسمية "إعدادات المستخدم"نرى الآن الملفين (UserInfoBoxControl.ascx و UserInfoBoxContrl.ascx.cs)الجديدين في مشروعك. أوّل ملفٍّ مذكور هوة ملف العلامات البرمجية, و الملف الثاني هوة ملفٌّ التعليمات البرمجية. الآن إن لم يكن الملف (UserInfoBoxControl.ascx) معرضا سابقا بشكلٍ تلقائي, فمن فضلك إفعل ذلك. ترى أمامك الآن سطراً واحدً من التلعليمات البرمجية (Code), وهوة سطرٌ يعلن عن "إعدادات المستخدم" الجديدة. و كما مذكور, هذه التعليمة البرمجية المتحكمة ستمكننامن إستدعاء و عرض معلوماتٍ عن "مستخدم",فلنبدأ الآن, مع إضافة بعضٍ من العلامات البرمجية في ملف ال(markup).

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="UserInfoBoxControl.ascx.cs" Inherits="UserInfoBoxControl" %>
<b>Information about <%= this.UserName %></b>
<br /><br />
<%= this.UserName %> is <%= this.UserAge %> years old and lives in <%= this.UserCountry %>

كما ترى في التعليمات البرمجية في الأعلى,نحن الآن في مرحلة أساسية خفيفة. لدينا تصريح عن "إعدادات المستخدم" الجديدة, بعض العلامات البرمجية الأساسية, بعض من النص العادي, و بعض من نوعٍ ما من المتغيرات(Variables). الآن, مين أين أتو المتغيرات ؟حسنا, بشكل مُبصّت أتو من لامكان, منذ أن لمن نصرّح عنهم بعد. من الأفضل أن نقوم الآنَ بذلك. قُم بإختيار و عرض ملف "التعليمات البرمجية" (UserInfoBoxContrl.ascx.cs) للإعدادات المستخدم الجديدة, المعلّمة بتسميتهى كما مذكور بين قوصين.

كما نرى, فإنّ الملف هوة كأي ملف من التعليمات البرمجية المئلوفه,بأستثناء أنه يورث من "إعدادات المستخدم" الجديدة (UserControl) عوضا عن أن يورث من ملفّ الصفحة. سنقوم أوّلاً بلتصريح عن البنية الهرمية "سلسة شجرة" لمجوعة خصائصنا المستعملة في "العللامات البرمجية", و نئسّسهم على ثلاث حقول مطابقة و مماثلة لهم.

private string userName;
private int userAge;
private string userCountry;

public string UserName
{
    get { return userName; }
    set { userName = value; }
}

public int UserAge
{
    get { return userAge; }
    set { userAge = value; }
}

public string UserCountry
{
    get { return userCountry; }
    set { userCountry = value; }
}

التعليمات بسيطة و تعمل كصف من التعليمات البرمجية المئلوفة. يمكنك إن أردت أيضاً إضافة أنظمة (methods)! الآن يمكنك القول إن "إعدادات المستخدم" تم إنهاء تهيئتها, ولكن كما قد تكون رأيت, فإنها لا تقوم بواجباتها,فلا يمن إستخدامها بعد. لأن تقوم "إعدادات المستخدم" الجديدة بلقيام بمهمتها و عرضها. يجب علينا أولاً بإضافتها إلى صفحة ويب, لا أن نبدء البرنامج على متصفح إنترنت

This article has been fully translated into the following languages: Is your preferred language not on the list? Click here to help us translate this article into your language!