سنناقش في هذا الفصل عناصر التحكم الأساسية المتوفرة في ASP.NET.
يوفر ASP.NET ثلاثة أنواع مختلفة من عناصر التحكم في الأزرار:
الزر : يعرض النص داخل منطقة مستطيلة.
زر الارتباط : يعرض النص مثل الارتباط التشعبي.
زر الصورة : يعرض صورة.
عندما ينقر المستخدم على زر، يتم إطلاق حدثين: النقر والأمر.
بناء الجملة الأساسي للتحكم في الزر:
<asp:Button ID="Button1" runat="server" onclick="Button1_Click" Text="Click" / >الخصائص الشائعة لعناصر التحكم في الأزرار:
| ملكية | يصف |
|---|---|
| نص | يتم عرض النص على الزر. عناصر التحكم في الأزرار وأزرار الارتباط فقط. |
| ImageUrl | فقط لعناصر التحكم في زر الصورة. هذه الصورة لتوضيح الزر |
| نص بديل | فقط لعناصر التحكم في زر الصورة. إذا لم يتمكن المتصفح من عرض الصورة، فسيتم عرض النص البديل. |
| الأسبابالتحقق من الصحة | يحدد ما إذا كان سيتم إجراء التحقق من صحة الصفحة عندما يقوم المستخدم بالنقر فوق الزر. الافتراضيات إلى صحيح. |
| اسم الأمر | قيمة السلسلة التي تم تمريرها إلى حدث الأمر عندما يقوم المستخدم بالنقر فوق الزر. |
| وسيطة الأوامر | قيمة السلسلة التي تم تمريرها إلى حدث الأمر عندما يقوم المستخدم بالنقر فوق الزر. |
| PostBackUrl | يظهر عنوان الصفحة المطلوبة عندما ينقر المستخدم على الزر. |
تم تصميم عنصر التحكم في مربع النص خصيصًا لقبول إدخال المستخدم. يمكن لعنصر تحكم مربع النص قبول إدخال نص واحد أو أكثر استنادًا إلى خاصية وضع النص.
توفر عناصر التحكم في التسمية طريقة بسيطة لعرض النص من صفحة إلى أخرى. إذا كنت تريد عرض نص ثابت، فيمكنك استخدام النص الحرفي.
بناء الجملة الأساسي للتحكم في النص:
<asp:TextBox ID="txtstate" runat="server" ></asp:TextBox>الخصائص الشائعة لمربعات النص والتسميات:
| ملكية | يصف |
|---|---|
| وضع النص | حدد نوع مربع النص. ينشئ وضع السطر الواحد نصًا قياسيًا، وينشئ الوضع متعدد الأسطر القدرة على قبول نصوص متعددة، وتتسبب كلمات المرور في وضع علامة على الأحرف ليتم إدخالها. الافتراضي هو النص القياسي. |
| نص | محتوى النص في مربع النص. |
| الطول الأقصى | أدخل الحد الأقصى لقيمة أحرف النص في مربع النص. |
| طَوّق | فهو يحدد ما إذا كان النص الموجود في مربع نص متعدد الأسطر سيتم التفافه تلقائيًا أم لا؛ القيمة الافتراضية هي True. |
| للقراءة فقط | يحدد ما إذا كان يمكن للمستخدم تغيير النص الموجود في المربع؛ والإعدادات الافتراضية هي خطأ، مما يعني أنه يمكن للمستخدم تغيير النص. |
| أعمدة | عرض مربع النص بالأحرف. يتم تحديد العرض الفعلي بناءً على الخط المستخدم لإدخال النص. |
| الصفوف | ارتفاع مربع النص متعدد الأسطر. القيمة الافتراضية هي 0، والتي تمثل مربع نص من سطر واحد. |
الخاصية الأكثر استخدامًا لعنصر تحكم التسمية هي "النص"، الذي يمثل النص المعروض على التسمية.
ستعرض خانة الاختيار خيارًا يمكن للمستخدم تحديده أو إلغاء تحديده. تقدم أزرار الاختيار مجموعة من الخيارات التي يمكن للمستخدم تحديد خيار واحد فقط منها.
إذا كنت تقوم بإنشاء مجموعة من أزرار الاختيار، فيمكنك تحديد نفس الاسم لخاصية GroupName في كل مجموعة أزرار اختيار. إذا كانت هناك حاجة إلى ظهور أكثر من مجموعة في نموذج واحد، فحدد اسم مجموعة مختلفًا لكل مجموعة.
إذا كنت تريد تحديد خانة الاختيار أو زر الاختيار كما يظهر في البداية، فاضبط الخاصية المحددة الخاصة به على true. إذا تم تعيين الخاصية الخاصة بأزرار الاختيار المتعددة في مجموعة على "صحيح"، فسيتم اعتبار الزر الأخير فقط صحيحًا.
بناء الجملة الأساسي لمربعات الاختيار:
<asp:CheckBox ID= "chkoption" runat= "Server"> </asp:CheckBox>بناء الجملة الأساسي لأزرار الاختيار:
<asp:RadioButton ID= "rdboption" runat= "Server"> </asp: RadioButton>الخصائص الشائعة لمربعات الاختيار وأزرار الاختيار:
| ملكية | يصف |
|---|---|
| نص | يتم عرض النص بجوار مربع الاختيار أو زر الاختيار. |
| تم الفحص | حدد ما إذا كان محددًا أم لا. |
| اسم المجموعة | اسم المجموعة التي ينتمي إليها عنصر التحكم. |
يوفر ASP.NET عناصر التحكم التالية:
القائمة المنسدلة,
مربع القائمة,
قائمة أزرار الراديو,
قائمة خانات الاختيار,
قائمة نقطية.
تسمح عناصر التحكم هذه للمستخدم بالاختيار من قائمة تحتوي على عنصر واحد أو أكثر. تحتوي مربعات القائمة والقوائم المنسدلة على عنصر قائمة واحد أو أكثر. يمكن تحميل هذه القوائم من خلال التعليمات البرمجية أو من خلال محرر ListItemCollection.
بناء الجملة الأساسي للتحكم في مربع القائمة:
<asp:ListBox ID="ListBox1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="ListBox1_SelectedIndexChanged"></asp:ListBox>بناء الجملة الأساسي للتحكم في القائمة المنسدلة:
<asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged"></asp:DropDownList>الخصائص الشائعة لمربعات القائمة والقوائم المنسدلة:
| ملكية | يصف |
|---|---|
| أغراض | مجموعة من كائنات ListItem التي تمثل العناصر الموجودة داخل عنصر التحكم. تقوم هذه الخاصية بإرجاع كائن من النوع ListItemCollection. |
| الصفوف | يحدد عدد العناصر التي سيتم عرضها في المربع. إذا كانت القائمة الفعلية تحتوي على صفوف أكثر من القائمة المعروضة، فستتم إضافة أشرطة التمرير. |
| الفهرس المحدد | فهرس العنصر المحدد حاليًا. إذا تم تحديد أكثر من عنصر واحد، يقوم الفهرس الأول بتحديد العنصر. إذا لم يتم تحديد أي عنصر، فإن قيمة هذه الخاصية هي -1. |
| القيمة المحددة | قيمة العنصر المحدد حاليًا. إذا تم تحديد أكثر من عنصر واحد، يتم تحديد قيمة العنصر الأول. إذا لم يكن هناك عنصر محدد، تكون قيمة هذه الخاصية عبارة عن سلسلة فارغة (""). |
| وضع التحديد | الإشارة إلى ما إذا كان مربع القائمة يسمح بتحديد واحد أو تحديدات متعددة. |
الخصائص الشائعة لكل كائن عنصر قائمة:
| ملكية | يصف |
|---|---|
| نص | النص المعروض للعنصر. |
| مختارة | يشير إلى ما إذا كان العنصر محددًا أم لا. |
| قيمة | سلسلة من الأحرف المرتبطة بالمشروع. |
الأشياء التي يجب التركيز عليها هي:
إذا كنت تريد العمل مع العناصر الموجودة في قائمة منسدلة أو مربع قائمة، فستحتاج إلى استخدام خاصية عنصر التحكم. تقوم هذه الخاصية بإرجاع كائن ListItemCollection الذي يحتوي على كافة عناصر القائمة.
يتم رفع الحدث SelectedIndexChanged عندما يقوم المستخدم بتحديد عنصر مختلف من القائمة المنسدلة أو مربع القائمة.
كائن ListItemCollection عبارة عن مجموعة من كائنات ListItem. يمثل كل كائن ListItem عنصرًا في القائمة. تبدأ أرقام العناصر في ListItemCollection من 0.
عندما تكون السلسلة المستخدمة في عملية تحميل العناصر في مربع قائمة، على سبيل المثال: lstcolor.Items.Add ("Blue")، فإن إعداد الخاصية للنص وقيمة عنصر القائمة هو قيمة السلسلة التي تحددها. من أجل إعداده بشكل مختلف، يجب عليك إنشاء كائن من عنصر القائمة ثم إضافة العنصر إلى المجموعة.
يتم استخدام محرر ListItemCollection لإضافة عناصر إلى القائمة المنسدلة أو مربع القائمة. يتم استخدامه لإنشاء قائمة ثابتة من العناصر. لعرض محرر المجموعة، حدد تحرير العنصر من قائمة العلامات الذكية، أو حدد عنصر التحكم وانقر فوق زر علامة القطع في خصائص العنصر في نافذة الخصائص.
الخصائص الشائعة لـ ListItemCollection:
| ملكية | يصف |
|---|---|
| العنصر (عدد صحيح) | كائن ListItem يمثل العنصر في الفهرس المحدد. |
| عدد | عدد العناصر في المجموعة. |
الطرق الأساسية لـ ListItemCollection:
| طريقة | يصف |
|---|---|
| إضافة (سلسلة) | إضافة عنصر جديد إلى نهاية المجموعة وتعيين معلمة السلسلة لخاصية نص العنصر. |
| إضافة (عنصر القائمة) | إضافة عنصر جديد إلى نهاية المجموعة. |
| إدراج (عدد صحيح، سلسلة) | إدراج عنصر في المجموعة في موضع الفهرس المحدد وتعيين وسيطة سلسلة لخاصية نص العنصر. |
| إدراج (عدد صحيح، عنصر القائمة) | إدراج عنصر في المجموعة في الفهرس المحدد. |
| إزالة (سلسلة) | إزالة العناصر التي لها نفس السلسلة مثل القيمة النصية. |
| إزالة (عنصر القائمة) | قم بإزالة العنصر المحدد. |
| إزالة في (عدد صحيح) | إزالة العنصر الموجود في الفهرس المحدد كعدد صحيح. |
| واضح | يزيل كافة العناصر من المجموعة. |
| FindByValue(سلسلة) | إرجاع نفس العنصر كقيمة السلسلة. |
| FindByValue (نص) | إرجاع نفس العنصر مثل السلسلة الحرفية. |
تقدم قائمة أزرار الاختيار قائمة بالخيارات المتبادلة. يقدم عمود قائمة مربعات الاختيار قائمة بالخيارات المستقلة. تحتوي عناصر التحكم هذه على مجموعة من كائنات ListItem، والتي يمكن الرجوع إليها من خلال خاصية عنصر التحكم.
بناء الجملة الأساسي لقائمة أزرار الاختيار:
<asp:RadioButtonList ID="RadioButtonList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="RadioButtonList1_SelectedIndexChanged"></asp:RadioButtonList>بناء الجملة الأساسي لقائمة مربعات الاختيار:
<asp:CheckBoxList ID="CheckBoxList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="CheckBoxList1_SelectedIndexChanged"></asp:CheckBoxList>الخصائص الشائعة لقوائم مربعات الاختيار وأزرار الاختيار:
| ملكية | يصف |
|---|---|
| تكرار التخطيط | تحدد هذه الخاصية ما إذا كان سيتم استخدام العلامات أو تدفق HTML العادي في عرض القائمة المنسقة. الافتراضي هو الجدول. |
| كرر الاتجاه | فهو يحدد الاتجاه الذي يمكن تكرار عنصر التحكم فيه. القيم المتاحة أفقية وعمودية. الافتراضي هو عمودي. |
| كرر الأعمدة | عند تكرار عنصر التحكم، فإنه يحدد رقم العمود الافتراضي؛ |
يقوم عنصر تحكم القائمة ذات التعداد النقطي بإنشاء قائمة ذات تعداد نقطي أو رقمي. تحتوي عناصر التحكم هذه على مجموعة من كائنات ListItem، والتي يمكن الرجوع إليها من خلال خاصية عنصر التحكم.
بناء الجملة الأساسي للقوائم النقطية:
<asp:BulletedList ID="BulletedList1" runat="server"></asp:BulletedList>الخصائص الشائعة للقوائم النقطية:
| ملكية | يصف |
|---|---|
| BulletStyle | تحدد هذه الخاصية نمط ومظهر أرقام العناصر أو أرقامها. |
| كرر الاتجاه | فهو يحدد الاتجاه الذي يمكن تكرار التحكم فيه. القيم المتاحة أفقية وعمودية. الافتراضي هو عمودي. |
| كرر الأعمدة | عند تكرار عنصر التحكم، فإنه يحدد رقم العمود الافتراضي؛ |
تشبه عناصر تحكم الارتباط التشعبي عناصر HTML <a> .
بناء الجملة الأساسي للتحكم في الارتباط التشعبي:
<asp:HyperLink ID="HyperLink1" runat="server"> HyperLink</asp:HyperLink>لديها الخصائص التالية:
| ملكية | يصف |
|---|---|
| ImageUrl | المسار إلى الصورة المعروضة بواسطة عنصر التحكم. |
| NavigateUrl | عنوان الارتباط المستهدف. |
| نص | النص المعروض كرابط. |
| هدف | النافذة أو الإطار الذي يقوم بتحميل الصفحة المرتبطة. |
إذا تعذر عرض الصورة، فسيعرض عنصر التحكم في الصورة الصورة على صفحة الويب أو بعض النصوص البديلة.
بناء الجملة الأساسي لعناصر التحكم في الصورة:
<asp:Image ID="Image1" runat="server">وله الخصائص الهامة التالية:
| ملكية | يصف |
|---|---|
| نص بديل | عرض نص بديل في حالة عدم وجود الصورة. |
| محاذاة الصورة | التحكم في خيارات المحاذاة. |
| ImageUrl | المسار إلى الصورة المعروضة بواسطة عنصر التحكم. |