?   ما هي الأدوات الأساسية في برمجة صفحات الويب آي إس بي  ASP.NET  Basic Controls#

---

الأدوات الأساسية في برمجة صفحات الويب آي إس بي ASP.NET Basic Controls#

في هذا الفصل ، سنناقش عناصر التحكم الأساسية المتوفرة في ASP.NET.

الأدوات الأزرار Button Controls

يوفر ASP.NET ثلاثة أنواع من التحكم بالزر:

•  زر button: يعرض النص داخل منطقة مستطيلة.
• زر الارتباطlink button: يعرض نصًا يشبه الارتباط التشعبي.
•  زر الصورةimage button: يعرض صورة.

 عندما ينقر المستخدم على زر ، يتم رفع حدثين: النقر والقيادة.

بناء الجملة الأساسية أو زر التحكم:

 ID="Button1" runat="server" onclick="Button1_Click" Text="Click" / >

Common properties of the button control:

الخصائص الشائعة في الأزرار 

:

الخاصية	الوصف
Text	يعرض النص الظاهري على الأداة
ImageUrl	للتحكم في زر الصورة فقط. الصورة التي سيتم عرضها للزر.
AlternateText	للتحكم في زر الصورة فقط. النص الذي سيتم عرضه إذا كان المستعرض لا يمكنه عرض الصورة.
CausesValidation	لتحديد ما إذا كان التحقق من صحة الصفحة يحدث عندما ينقر المستخدم على الزر. الافتراضي هو الصحيح.
CommandName	قيمة سلسلة يتم تمريرها إلى حدث الأمر عندما ينقر المستخدم فوق الزر.
CommandArgument	قيمة سلسلة يتم تمريرها إلى حدث الأمر عندما ينقر المستخدم فوق الزر.
PostBackUrl	عنوان URL للصفحة المطلوبة عند قيام المستخدم بالنقر فوق الزر.

العناويناو التسميات و مربع النص Text Boxes and Labels

تستخدم عناصر تحكم مربع النص عادةً لقبول إدخال المستخدم. يمكن لعنصر تحكم مربع النص قبول سطر واحد أو أكثر من النص وفقًا لإعدادات سمة TextMode.

 توفر عناصر التحكم في التسمية طريقة سهلة لعرض النص الذي يمكن تغييره من تنفيذ صفحة إلى أخرى. إذا كنت تريد عرض نص لا يتغير ، يمكنك استخدام النص الحرفي.

 بناء الجملة الأساسي أو التحكم في النص:

 ID="txtstate" runat="server" >

الخصائص الشائعة لمربع النص والتسميات:

الخاصية	الوصف
TextMode	يحدد نوع مربع النص. ينشئ SingleLine مربع نص قياسي ، ويقوم MultiLIne بإنشاء مربع نص يقبل أكثر من سطر واحد من النص ويؤدي كلمة المرور إلى إخفاء الأحرف التي تم إدخالها. الافتراضي هو SingleLine.
Text	محتوى النص لمربع النص.
MaxLength	الحد الأقصى لعدد الأحرف التي يمكن إدخالها في مربع النص.
Wrap	يحدد ما إذا كان النص يلتف تلقائيًا لمربع النص متعدد الأسطر أم لا ؛ الافتراضي هو الصحيح.
ReadOnly	يحدد ما إذا كان يمكن للمستخدم تغيير النص في المربع ؛ الافتراضي خطأ ، بمعنى أنه لا يمكن للمستخدم تغيير النص.
Columns	عرض مربع النص بالأحرف. يتم تحديد العرض الفعلي بناءً على الخط المستخدم لإدخال النص.
Rows	ارتفاع مربع النص متعدد الأسطر في االمربع. القيمة الافتراضية هي 0 ، مما يعني مربع نص بسطر مفرد.

السمة الأكثر استخدامًا لعنصر تحكم التسمية هي "نص" ، مما يعني النص المعروض على الملصق.

ازار الاختيار واحد او ازار اختيار اكثر من واحد متعدد Check Boxes and Radio Buttons

تعرض خانة الاختيار خيارًا واحدًا يمكن للمستخدم إما التحقق منه أو إلغاء تحديده وتقديم أزرار الاختيار مجموعة من الخيارات التي يمكن للمستخدم من خلالها تحديد خيار واحد فقط.

 لإنشاء مجموعة من أزرار الاختيار ، يمكنك تحديد الاسم نفسه لسمة GroupName لكل زر اختيار في المجموعة. إذا كان أكثر من مجموعة واحدة مطلوبًا في نموذج واحد ، فحدد اسمًا مختلفًا لكل مجموعة.

 إذا كنت تريد تحديد خانة الاختيار أو زر الاختيار عندما يتم عرض النموذج في البداية ، فقم بتعيين السمة المحددة على "صحيح". إذا تم تعيين السمة المحددة على "صحيح" لأزرار الاختيار المتعددة في مجموعة ، فسيتم اعتبار آخر واحد فقط صحيحاً.

بناء الجملة الأساسي أو خانة الاختيار:

 ID= "chkoption" runat= "Server">

بناء الجملة الأساسي أو زر الاختيار:

 ID= "rdboption" runat= "Server">

: RadioButton>

الخصائص الشائعة لخانات الاختيار وأزرار الاختيار:

الخاصية	الوصف
Text	النص المعروض بجوار خانة الاختيار أو زر الاختيار.
Checked	يحدد ما إذا كان محددًا أم لا ، بشكل افتراضي خطأ.
GroupName	اسم المجموعة التي ينتمي إليها عنصر التحكم.

ادوات للقائمة List Controls

 يوفر ASP.NET عناصر التحكم التالية

• قائمة المنسدلة Drop-down list,
• قائمة الصندوقية او المربع List box,

• قائمة ازار احادية الاختيار Radio button list,
• قائمة ازاى اختيار من متعدد Check box list,
• قائمة ذات عناصر لها رموز Bulleted list.

يتيح عنصر التحكم هذا للمستخدم الاختيار من عنصر واحد أو أكثر من القائمة. تحتوي مربعات القوائم والقوائم المنسدلة على عنصر قائمة أو أكثر. يمكن تحميل هذه القوائم إما عن طريق الرمز أو بواسطة محرر ListItemCollection.

 بناء الجملة الأساسي لعنصر تحكم مربع القائمة:

 ID="ListBox1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="ListBox1_SelectedIndexChanged">

بناء الجملة الأساسي أو التحكم في القائمة المنسدلة:

 ID="DropDownList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged">

الخصائص الشائعة لمربع القائمة والقوائم المنسدلة:

الخاصية	الوصف
Items	قائمة كائنات ListItem التي تمثل العناصر الموجودة في عنصر التحكم. هذه الخاصية بإرجاع كائن من نوع ListItemCollection.
Rows	يحدد عدد العناصر المعروضة في المربع. إذا كانت القائمة الفعلية تحتوي على عدد أكبر من الصفوف المعروضة ، فسيتم إضافة شريط تمرير.
SelectedIndex	فهرس العنصر المحدد حاليًا. إذا تم تحديد أكثر من عنصر ، فسيتم فهرسة العنصر المحدد الأول. إذا لم يتم تحديد أي عنصر ، تكون قيمة هذه الخاصية هي -1.
SelectedValue	قيمة العنصر المحدد حاليًا. إذا تم تحديد أكثر من عنصر ، فإن قيمة العنصر المحدد الأول. إذا لم يتم تحديد أي عنصر ، تكون قيمة هذه الخاصية عبارة عن سلسلة فارغة ("").
SelectionMode	يشير إلى ما إذا كان مربع القائمة يسمح بتحديدات مفردة أم متعددة.

الخصائص الشائعة لكل كائنات عناصر القائمة:

الخاصية	الوصف
Text	النص المعروض للعنصر.
Selected	يشير إلى ما إذا كان العنصر محددًا أم لا.
Value	قيمة سلسلة مرتبطة بالعنصر.

• من المهم ملاحظة ما يلي:
• للعمل مع العناصر الموجودة في القائمة المنسدلة أو مربع القائمة ، يمكنك استخدام الخاصية Items لعنصر التحكم. هذه الخاصية تقوم بإرجاع كائن ListItemCollection الذي يحتوي على كافة العناصر الموجودة في القائمة.
   يتم رفع الحدث SelectedIndexChanged عندما يحدد المستخدم عنصرًا مختلفًا من القائمة المنسدلة أو مربع القائمة.

مجموعة قائمة العناصرThe ListItemCollection

كائن ListItemCollection هو مجموعة من الكائنات ListItem. يمثل كل كائن ListItem عنصرًا واحدًا في القائمة. يتم ترقيم العناصر في ListItemCollection من 0.

 عندما يتم تحميل العناصر الموجودة في مربع القائمة باستخدام سلاسل مثل: lstcolor.Items.Add ("Blue") ، يتم تعيين كل من خصائص النص والقيمة لعنصر القائمة على قيمة السلسلة التي تحددها. لتعيينه بشكل مختلف ، يجب عليك إنشاء كائن عنصر قائمة ثم إضافة هذا العنصر إلى المجموعة.

 يتم استخدام ListItemCollection Editor لإضافة عنصر إلى قائمة أو مربع قائمة منسدلة. يستخدم هذا لإنشاء قائمة ثابتة من العناصر. لعرض محرر المجموعة ، حدد تحرير عنصر من قائمة العلامات الذكية ، أو حدد عنصر التحكم ، ثم انقر فوق زر علامة القطع من خاصية العنصر في نافذة الخصائص.

 الخصائص الشائعة لـ ListItemCollection:

الخاصية	الوصف
Item(integer)	كائن ListItem يمثل العنصر في الفهرس المحدد.
Count	عدد العناصر في المجموعة.

الطرق الشائعة لـ ListItemCollection:

الدالة	الوصف
Add(string)	يضيف عنصرًا جديدًا في نهاية المجموعة ويعين معلمة السلسلة إلى خاصية Text الخاصة بالعنصر.
Add(ListItem)	يضيف عنصرًا جديدًا في نهاية المجموعة.
Insert(integer, string)	إدراج عنصر في موقع الفهرس المحدد في المجموعة ، ويقوم بتعيين معلمات السلسلة إلى خاصية النص للعنصر.
Insert(integer, ListItem)	إدراج العنصر في موقع الفهرس المحدد في المجموعة.
Remove(string)	يزيل العنصر مع قيمة النص مثل السلسلة.
Remove(ListItem)	يزيل العنصر المحدد.
RemoveAt(integer)	يزيل العنصر في الفهرس المحدد كعدد صحيح.
Clear	يزيل كل العناصر من المجموعة.
FindByValue(string)	إرجاع العنصر الذي تكون قيمته هي نفس السلسلة.
FindByValue(Text)	إرجاع العنصر الذي يكون نصه هو نفسه السلسلة.

 قائمة الاختيار من متعدد والاختيار الأحادي Radio Button list and Check Box list

تقدم قائمة زر الاختيار قائمة بالخيارات المتبادلة. تعرض قائمة خانة الاختيار قائمة بالخيارات المستقلة. تحتوي عناصر التحكم هذه على مجموعة من الكائنات ListItem التي يمكن الإشارة إليها من خلال خاصية Items لعنصر التحكم.

 بناء الجملة الأساسي لقائمة زر الاختيار:

 ID="RadioButtonList1" runat="server" AutoPostBack="True"
 OnSelectedIndexChanged="RadioButtonList1_SelectedIndexChanged">

بناء الجملة الأساسية أو قائمة خانة الاختيار:

 ID="CheckBoxList1" runat="server" AutoPostBack="True"
 OnSelectedIndexChanged="CheckBoxList1_SelectedIndexChanged">

الخصائص الشائعة لخانة الاختيار وقوائم زر الاختيار:

الخاصية	الوصفة
RepeatLayout	تحدد هذه السمة ما إذا كان يجب استخدام علامات الجدول أو تدفق html العادي أثناء تنسيق القائمة عند تقديمها. الافتراضي هو الجدول.
RepeatDirection	يحدد الاتجاه الذي تتكرر فيه عناصر التحكم. القيم المتاحة هي أفقي وعمودي. الافتراضي عمودي.
RepeatColumns	يحدد عدد الأعمدة التي يجب استخدامها عند تكرار عناصر التحكم ؛ الافتراضي هو 0.

قائمة الرقمية والمنقطة Bulleted lists and Numbered lists

ينشئ عنصر التحكم قائمة نقطية قوائم نقطية أو قوائم ذات تعداد رقمي. تحتوي عناصر التحكم هذه على مجموعة من الكائنات ListItem التي يمكن الإشارة إليها من خلال خاصية Items لعنصر التحكم.

 بناء الجملة الأساسي لقائمة نقطية:

 ID="BulletedList1" runat="server">

الخصائص الشائعة للقائمة النقطية:

الخاصية	الوصف
BulletStyle	تحدد هذه الخاصية نمط الرموز النقطية أو أرقامها ومظهرها.
RepeatDirection	يحدد الاتجاه الذي تتكرر فيه عناصر التحكم. القيم المتاحة هي أفقي وعمودي. الافتراضي عمودي.
RepeatColumns	يحدد عدد الأعمدة التي يجب استخدامها عند تكرار عناصر التحكم ؛ الافتراضي هو 0.

اداة الوصلة التشعبية HyperLink

يشبه عنصر تحكم HyperLink عنصر HTML  بناء الجملة الأساسي لعنصر تحكم الارتباط التشعبي:

 ID="HyperLink1" runat="server">
 HyperLink

له الخصائص المهمة التالية:

الخاصية	الوصف
ImageUrl	مسار الصورة ليتم عرضها بواسطة عنصر التحكم.
NavigateUrl	عنوان URL للرابط الهدف.
Text	النص الذي سيتم عرضه على شكل رابط.
Target	الإطار أو الإطار الذي يحمّل الصفحة المرتبطة.

الأداة الصورة Image Control

يتم استخدام عنصر تحكم الصورة لعرض الصور على صفحة الويب ، أو بعض النصوص البديلة ، إذا كانت الصورة غير متوفرة.

 بناء الجملة الأساسي لعنصر تحكم الصورة:

 ID="Image1" runat="server">

له الخصائص المهمة التالية:

الخاصية	الوصف
AlternateText	نص بديل ليتم عرضها في غياب الصورة.
ImageAlign	خيارات المحاذاة لعنصر التحكم.
ImageUrl	مسار الصورة ليتم عرضها بواسطة عنصر التحكم