? ما هي الأدوات الأساسية في برمجة صفحات الويب آي إس بي 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 | مسار الصورة ليتم عرضها بواسطة عنصر التحكم |