مشاركة عبر

HtmlForm خادم تحكم بناء الجملة المصرح به

  • مقالة

ينشئ عنصر تحكم من جانب الخادم بتعيين إلى <form>عنصر HTML ويسمح لك إلى إنشاء حاوية لعناصر في الصفحة ويب.

<form 
    DefaultButton="string"
    DefaultFocus="string"
    EnableViewState="False|True"
    Id="string"
    SubmitDisabledControls="False|True"
    Visible="True|False"
    OnDataBinding="OnDataBinding event handler"
    OnDisposed="OnDisposed event handler"
    OnInit="OnInit event handler"
    OnLoad="OnLoad event handler"
    OnPreRender="OnPreRender event handler"
    OnUnload="OnUnload event handler"
    runat="server"
    >
        <!--Other controls, input forms, and so on.--> 
</form>

ملاحظات

استخدام HtmlFormعنصر تحكم إلى البرنامج مقابل HTML <form>العنصر. يستفيد من الخدمات إعادة النشر الكل عناصر تحكم "نماذج ويب" ما إذا كان يجب أن تتداخل HTML عناصر تحكم ويب عناصر التحكم, عناصر تحكم المستخدم أو عناصر التحكم المخصصة بين جيد فتح وإغلاق العلامات HtmlFormعنصر التحكم. إذا لم يتم غلق العلامات بشكل صحيح، ASP.NET لن تتعرف على العنصر. إما أنه سيتم تجاهل العنصر أو يحدث خطأ التحويل برمجي, اعتماداً على كيفية تشكيل العنصر.

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

لا يمكنك تضمين أكثر من HtmlFormعنصر تحكم على واحدة "نماذج ويب" الصفحة.

بشكل افتراضي، HtmlFormعنصر تحكم methodتعيين السمة إلى POST. يمكنك يخصص methodالسمة لتناسب احتياجات ولكن الإعداد methodالسمة على القيمة غير GETأو POSTمقاطعة بالولاية العرض المضمنة ثم إعادة النشر الخدمات المقدمة بواسطة ASP.NET.

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

actionدائماً يتم تعيين السمة إلى محدد موقع المعلومات (URL) لالصفحة نفسه.actionيتعذر تم تغييره السمة; لذلك، يمكنك فقط إرسال إلى الصفحة نفسها.
ملاحظةملاحظة

nameسمة ل formعناصر هو مهمل في XHTML 1.1.لذلك، فإن عنصر التحكم هذا لا يعرض السمة name في ASP.NET 4.

مثال

يظهر المثال التالي HtmlButtonعناصر تحكم مع منفصل ثلاثة OnServerClickمعالج لكل زر. كل من هذه الأحداث يؤدي إلى إعادة النشر إلى الخادم ( HtmlFormالتحكم مطلوب من أجل أي السيناريو تحدث إعادة النشر). يوضح هذا المثال أيضاً ذلك واحد فقط HtmlFormمسموح عنصر تحكم على الصفحة "ويب النماذج" بما في ذلك نموذج الذي يعتمد عدة أحداث. إذا قمت بتضمين HtmlFormعنصر تحكم، سيقوم بطرح .NET Framework " واحد أو أكثر على ‏‏ استثناء.

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlForm Control</title>

   <script runat="server">
      Sub Button1_OnClick(Source As Object, e As EventArgs)
         Span1.InnerHtml = "You clicked Button1"
      End Sub

      Sub Button2_OnClick(Source As Object, e As EventArgs)
         Span2.InnerHtml = "You clicked Button2"
      End Sub

      Sub Button3_OnClick(Source As Object, e As EventArgs)
         Span3.InnerHtml = "You clicked Button3"
      End Sub
   </script>

</head>
<body>

   <h3>HtmlForm Sample</h3>

   <form id="ServerForm" runat="server">     
      <button id="Button1" runat="server"
              onserverclick="Button1_OnClick">
         Button1
      </button>
      &nbsp;&nbsp;
      <span id="Span1" runat="server" />
      <p />
      <button id="Button2" runat="server"
              onserverclick="Button2_OnClick">
         Button2
      </button>
      &nbsp;&nbsp;
      <span id="Span2" runat="server" />
      <p />
      <button id="Button3" runat="server"
              onserverclick="Button3_OnClick">
         Button3
      </button>
      &nbsp;&nbsp;
      <span id="Span3" runat="server" />
   </form>
</body>
</html>

<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlForm Control</title>

    <script runat="server">
       void Button1_OnClick(object Source, EventArgs e) 
       {
          Span1.InnerHtml="You clicked Button1";
       }
       void Button2_OnClick(object Source, EventArgs e) 
       {
          Span2.InnerHtml="You clicked Button2";
       }
       void Button3_OnClick(object Source, EventArgs e) 
       {
          Span3.InnerHtml="You clicked Button3";
       }
    </script>

</head>
<body>

   <h3>HtmlForm Sample</h3>

   <form id="ServerForm" runat="server">     
      <button id="Button1" runat="server"
              onserverclick="Button1_OnClick">
         Button1
      </button>
      &nbsp;&nbsp;
      <span id="Span1" runat="server" />
      <p />
      <button id="Button2" runat="server"
              onserverclick="Button2_OnClick">
         Button2
      </button>
      &nbsp;&nbsp;
      <span id="Span2" runat="server" />
      <p />
      <button id="Button3" runat="server"
              onserverclick="Button3_OnClick">
         Button3
      </button>
      &nbsp;&nbsp;
      <span id="Span3" runat="server" />
   </form>
</body>
</html>

راجع أيضًا:

المرجع

HtmlForm

موارد أخرى

عناصر تحكم خادم HTML