مشاركة عبر

عنصر تحكم الخادم HtmlGenericControl المصرح البناء

  • مقالة

ينشئ عنصر تحكم من جانب الخادم بتعيين عناصر HTML لا تكون ممثلة على فئة .NET Framework محدد, مثل <body>و <div>.

<span | body | div | font | others 
    EnableViewState="False|True" 
    ID="string" 
    OnDataBinding="OnDataBinding event handler" 
    OnDisposed="OnDisposed" 
    OnInit="OnInit event handler" 
    OnLoad="OnLoad event handler" 
    OnPreRender="OnPreRender event handler" 
    OnServerClick="OnServerClick event handler" 
    OnUnload="OnUnload event handler"
    runat="server" 
    Visible="False|True" >
    contentBetweenTags 
</span | body | div | font | others>

ملاحظات

يتم إنشاء عنصر تحكم هذا على الخادم استجابة العلامات التي تتضمن runat="server"/ القيمة السمة الخاصة ينشئ ازدواجًا في عناصر عدم التعيين مباشرةً إلى محدد HTML عنصر تحكم. تتضمن هذه العناصر في <span>، <body>، <div>, و <font>عناصر أخرى. عنصر التحكم بتعيين اسم علامة العنصر معينة ليتم استخدامه على أنه عنصر تحكم HTML إلى ASP.NET خلال TagNameالخاصية. يرث عنصر التحكم هذا الأداء الوظيفي من HtmlContainerControlفئة مما يسمح لك إلى بشكل حيوي تغيير الداخلي محتويات عنصر تحكم HTML العلامات.

يمكنك استخدام من جانب الخادم <span>عنصر لعرض النص التي تم إنشاؤها بواسطة معالج أحداث تعليمات برمجية, سواء عبر إدخال المستخدم أو من المصدر تقوم بتعيينها في معالج الأحداث الخاص بك. يمكنك أيضاً استخدام Page_Loadالحدث إلى إنشاء النص في عنصر تحكم نطاق وسمات HTML نمط إلى تنسيق النص عند عرضه في المستعرض.

مثال

يوضح المثال التالي كيف يمكنك إنشاء نص لعرض استناداً إلى إدخال المستخدم في عنصر HtmlInputTextعنصر تحكم. HtmlGenericControl، والذي يتم إنشاؤه بواسطة للتصريح <span>عنصر تشغيل يوفر الصفحة، <span>عنصر لديه حق الوصول إلى InnerHtmlالخاصية. يسمح لك هذا إلى التعامل مع السلسلة النصية المعينة إلى <span>العنصر.

<%@ 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>HtmlGenericControl Control</title>

   <script runat="server">
      Sub SubmitBtn_Click(Source As Object, e As EventArgs)
         MySpan.InnerHtml = "Welcome to ASP.NET, " & myText.Value & "."
      End Sub
   </script>

</head>
<body>
   <form id="myForm" runat="server">
   <br />
   Enter your name here: 
   <input type="text" id="myText" runat="server" />
   <br /><br />
   <input id="Submit1" type="submit" value="Click Here!"
          onserverclick="SubmitBtn_Click" runat="server" />
   <br /><br />
   <b><span id="MySpan" runat="server"/></b>
   </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>HtmlGenericControl Control</title>

   <script runat="server">
      void SubmitBtn_Click(object Source, EventArgs e) 
      {
         MySpan.InnerHtml = "Welcome to ASP.NET, " + myText.Value + ".";
      }
   </script>

</head>
<body>
   <form id="myForm" runat="server">
   <br />Enter your name here: 
   <input type="text" id="myText" runat="server" />
   <br /><br />
   <input id="Submit1" type="submit" value="Click Here!"
          onserverclick="SubmitBtn_Click" runat="server" />
   <br /><br />
   <b><span id="MySpan" runat="server"/></b>
   </form>
</body>
</html>

يظهر المثال التالي كيفية استخدام HtmlGenericControlإلى تسمح لمستخدم إلى تعديل لون خلفية الصفحة. كما يوضح كيفية إلى استخدام AttributeCollectionفئة إلى للوصول برمجياً السمات التي يمكن أن يتم تعريف على أي عنصر تحكم HTML.

<%@ 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>HtmlGenericControl Control</title>

   <script runat="server">
      Sub SubmitBtn_Click(Source As Object, e As EventArgs)
         Body.Attributes("bgcolor") = ColorSelect.Value
      End Sub
   </script>

</head>

<body id="Body" runat="server">

   <h3>Updating Styles with the HtmlGenericControl</h3>

   <form id="Form1" runat="server">
      <br />
      Select a background color for the page: <br />
      <select id="ColorSelect" runat="server">
         <option>White</option>
         <option>Wheat</option>
         <option>Gainsboro</option>
         <option>LemonChiffon</option>
      </select>
      <input id="Submit1" type="submit" runat="server" 
             value="Apply" onserverclick="SubmitBtn_Click" />
   </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>HtmlGenericControl Control</title>

   <script runat="server">
      void SubmitBtn_Click(object Source, EventArgs e) 
      {
         Body.Attributes["bgcolor"] = ColorSelect.Value;
      }
   </script>

</head>

<body id="Body" runat="server">

   <h3>Updating Styles with the HtmlGenericControl</h3>

   <form id="Form1" runat="server">
      <br />
      Select a background color for the page: <br />
      <select id="ColorSelect" runat="server">
         <option>White</option>
         <option>Wheat</option>
         <option>Gainsboro</option>
         <option>LemonChiffon</option>
      </select>
      <input id="Submit1" type="submit" runat="server" 
             value="Apply" onserverclick="SubmitBtn_Click" />
   </form>
</body>
</html>

راجع أيضًا:

المرجع

HtmlGenericControl

موارد أخرى

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