This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

HtmlForm الفئة

Visual Studio 2010

يوفر الوصول المبرمج إلى HTML <form>العنصر تشغيل الخادم.

مساحة الاسم:  System.Web.UI.HtmlControls
التجميع:  System.Web (في System.Web.dll)

public class HtmlForm : HtmlContainerControl
<asp:HtmlForm />

HtmlForm عنصر التحكم هو بمثابة حاوية لعناصر تحكم الملقم تشغيل صفحة "نماذج ويب". يجب أن توضع عنصر تحكم s الالخادم الجميع والتي يتم نشرها إلى الالخادم بين الفتح والإغلاق علامات من HtmlFormعنصر تحكم.

ملاحظةملاحظة

يسمح ASP.NET فقط تشغيل واحدة HtmlFormعنصر تحكم أن تكون نشطة تشغيل صفحة "نماذج ويب". إذا كان هناك هو نشط واحد أو أكثر HtmlFormسيتم طرح عنصر تحكم في صفحة "نماذج ويب"، فإن وقت تشغيل اللغة العامة System.Web.HttpException‏‏ استثناء عند طلب الصفحة. ومع ذلك، يمكنك استخدام MultiViewالتحكم في مكان كل Viewيحتوي الكائن على HtmlFormالتحكم، لأن واحد فقط Viewهو النشط في أي وقت معطى.

يمكنك عنصر تحكم السلوك HtmlFormعنصر تحكم بتعيين الخصائص الخاصة به. إلى تحديد نوع الترميز لبيانات النموذج، قم بتعيين Enctypeخاصية. الأسلوب ( GETأو POST) التي يستخدمها مستعرض لنشر بيانات النموذج إلى الخادم لمعالجة هو المحدد بواسطة الإعداد Methodخاصية.

ملاحظة تنبيهتنبيه

قم بتعيين خاصية Method التابعة للخاصية POST. يمكنك تعديل القيمة هذه خاصية إلى GET، ولكن هذا قد قطع الولاية المضمنة و إعادة النشر الخدمات المقدمة بواسطة إطار عمل الصفحة ASP.NET.

يمكنك تكوين عناصر التحكم التي تقوم بتنفيذ IButtonControlواجهة إلى نشر إلى صفحة هدف آخر. Th هو هو يشار إليها عبر صفحة نشر. لمزيد من المعلومات، راجع صفحة عبر للإرسال في صفحات ويب ASP.NET.

للحصول على قائمة قيم الخصائص الأولية لمثيل HtmlForm، انظر HtmlFormالدالة الإنشائية.

يوضح مثال التعليمة البرمجية التالية كيف إلى استخدام HtmlFormالفئة إلى بإنشاء نموذج بسيط.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void AddButton_Click(Object sender, EventArgs e)
    {

        int Answer;

        // Calculate and display the result.
        Answer = Convert.ToInt32(Value1.Value) + Convert.ToInt32(Value2.Value);
        AnswerMessage.InnerHtml = Answer.ToString();

    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" > 
<head>
  <title>HtmlForm Example</title>
</head>
<body>

   <form method="Post"
         enctype="application/x-www-form-urlencoded" 
         runat="server" id="myform">

      <h3> HtmlForm Example </h3>

      <table>
         <tr>
            <td colspan="5">
               Enter integer values into the text boxes. <br />
               Click the Add button to add the two values. <br />
               Click the Reset button to reset the text boxes.
            </td>
         </tr>
         <tr>
            <td colspan="5">
               &nbsp;
            </td>
         </tr>
         <tr align="center">
            <td>
               <input id="Value1"
                      type="Text"
                      size="2"
                      maxlength="3"
                      value="1"
                      runat="server"/>
            </td>
            <td>
               + 
            </td>
            <td>
               <input id="Value2"
                      type="Text"
                      size="2"
                      maxlength="3"
                      value="1"
                      runat="server"/>
            </td>
            <td>
               =
            </td>
            <td>
               <span id="AnswerMessage"
                     runat="server"/>
            </td>
         </tr>
         <tr>
            <td colspan="2">
               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:CompareValidator
                    ID="Value1MinCompareValidator"
                    ControlToValidate="Value1"
                    Operator="LessThan"
                    Type="Integer"
                    ValueToCompare="100"
                    ErrorMessage="Please enter an integer less than 100.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:CompareValidator
                    ID="Value1MaxCompareValidator"
                    ControlToValidate="Value1"
                    Operator="GreaterThan"
                    Type="Integer"
                    ValueToCompare="0"
                    ErrorMessage="Please enter an integer greater than 0.<br />"
                    Display="Dynamic"
                    runat="server"/>
            </td>
            <td colspan="2">
               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:CompareValidator
                    ID="Value2MinCompareValidator"
                    ControlToValidate="Value2"
                    Operator="LessThan"
                    Type="Integer"
                    ValueToCompare="100"
                    ErrorMessage="Please enter an integer less than 100.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:CompareValidator
                    ID="Value2MaxCompareValidator"
                    ControlToValidate="Value2"
                    Operator="GreaterThan"
                    Type="Integer"
                    ValueToCompare="0"
                    ErrorMessage="Please enter an integer greater than 0.<br />"
                    Display="Dynamic"
                    runat="server"/>

            </td>
            <td>
               &nbsp;
            </td>
         </tr>
         <tr align="center">
            <td colspan="4">
               <input type="Submit"
                      name="AddButton"
                      value="Add"
                      onserverclick="AddButton_Click"
                      runat="server"/>

               &nbsp;&nbsp;&nbsp;

               <input type="Reset"
                      name="AddButton"
                      value="Reset"
                      runat="server"/>
            </td>
            <td>
               &nbsp;
            </td>
         </tr>
      </table>

   </form>
</body>
</html>


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: