home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 40 / IOPROG_40.ISO / SOFT / NETFrameworkSDK.exe / comsdk.cab / samples.exe / QuickStart / aspplus / doc / webformssyntaxref.aspx < prev    next >
Encoding:
Text File  |  2000-06-01  |  11.9 KB  |  337 lines
  1. <%@Page Language="cs"%>
  2. <%@ Register TagPrefix="Acme" TagName="SourceRef" Src="/quickstart/util/SrcRef.aspx"%>
  3.  
  4. <!-- #include virtual="/quickstart/aspplus/include/header.inc" -->
  5.  
  6. <h4>Web Forms Syntax Reference</h4>
  7. <p>
  8.  
  9. <div class="indent" style="font-family:Verdana; font-size:8pt;">
  10.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#syntax">ASP+ Web Forms Syntax Elements</a><br>
  11.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#render">Rendering Code Syntax</a><br>
  12.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#code">Declaration Code Syntax</a><br>
  13.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#ctrl">ASP+ Server Control Syntax</a><br>
  14.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#htmlctrl">ASP+ Html Server Control Syntax </a><br>
  15.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#databind">Databinding Syntax</a><br>
  16.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#object">Object Tag Syntax</a><br>
  17.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#comment">Server Side Comment Syntax</a><br>
  18.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b><a class="toc2" target="content" href="#include">Server Side Include Syntax</a><br>
  19. </div>
  20. <p>
  21. <hr>
  22.  
  23. <!--BEGIN SECTION-->
  24. <a name="syntax">
  25. <span class="subhead">ASP+ Web Forms Syntax Elements</span>
  26. <p>
  27.  
  28. An ASP+ Web Form Page is a declarative text file with a ".ASPX" filename extension.
  29. In addition to static text content, it can contain eight distinct syntax markup
  30. elements.  This section of the quickstart reviews each different syntax elements and
  31. provides an example demonstrating its use.
  32.  
  33.  
  34. <!--BEGIN SECTION-->
  35. <br>
  36. <a name="render">
  37. <br>
  38. <span class="subhead">Rendering Code Syntax: <% %>  and <%= %></span>
  39. <p>
  40.  
  41. Code rendering blocks are denoted with <% ... %> elements, and enable developers 
  42. to custom-control content emission.  They execute during the "render" phase of 
  43. page execution.  The below sample demonstrates how they can be used to loop over some HTML content:
  44.  
  45. <div class="code"><pre>
  46. <% for (int i=0; i<8; i++) { %>
  47.      <font size="<%=i%>"> Hello World! </font> <br>
  48. <% } %>
  49. </pre></div>
  50. <p>
  51.  
  52. <Acme:SourceRef
  53.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference1.aspx"
  54.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference1.src"
  55.   Icon="/quickstart/aspplus/images/reference1.gif"
  56.   Caption="Reference1.aspx"
  57.   runat="server" />
  58.  
  59. <p>
  60. Code enclosed by <% ... %> is just executed, whereas expressions like
  61. <%= ... %> are evaluated and the result is emitted as content. Therefore
  62. <nobr><%="Hello World" %></nobr> is equivalent to 
  63. <nobr><% Response.Write("Hello World"); %></nobr> (in C#). 
  64. <p>
  65. <b>Note:</b> For languages, which utilize marks to end or separate statements (e.g. ";"
  66. in C#), it is important to respect them in both cases:
  67. <p>
  68. <div class="indent">
  69. <table class="table2" cellpadding=3>
  70. <tr><th colspan="2"><b>C# code</b></th></tr>
  71. <tr>
  72.   <td><div class="code"><% Response.Write("Hello World"); %></div></td>
  73.   <td>semicolon is necessary to end statement</td></tr>
  74. <tr>
  75.   <td><div class="code"><%="Hello World"; %></div></td>
  76.   <td>WRONG: Would result in "<code>Response.Write("Hello World";);</code>"</td></tr>
  77. <tr>
  78.   <td><div class="code"><%="Hello World" %></div></td><td>OK</td></tr>
  79. </table>
  80. </div>
  81.  
  82. <!--BEGIN SECTION-->
  83. <br>
  84. <a name="code">
  85. <br>
  86. <span class="subhead">Declaration Code Syntax: <script runat="server"> </span>
  87. <p>
  88.  
  89. Code declaration blocks define member variables and methods that will be compiled into the 
  90. generated Page class.  Developers use these blocks to author page/navigation logic.  
  91. The below example demonstrates how a "Subtract" method can be declared within a 
  92. <script runat="server"> block, and then invoked from the page:
  93.  
  94. <div class="code"><pre>
  95. <script language="C#" runat=server>
  96. int subtract(int num1, int num2) 
  97. {
  98.   return num1 - num2;
  99. }
  100. </script>
  101.  
  102. <%
  103.   ...
  104.   number = subtract(number, 1);
  105.   ...
  106. %>
  107. </pre></div>
  108.  
  109.  
  110. <p>
  111.  
  112. <Acme:SourceRef
  113.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference2.aspx"
  114.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference2.src"
  115.   Icon="/quickstart/aspplus/images/reference2.gif"
  116.   Caption="Reference2.aspx"
  117.   runat="server" />
  118.  
  119. <p>
  120.  
  121. <b>Important:</b> Unlike ASP -- where functions could be declared within <% %> blocks --
  122. all functions and global page variables must be declared in a <script runat=server>
  123. tag.  Functions declared within <% %> block will now generate a syntax compile error.
  124.  
  125.  
  126.  
  127. <!--BEGIN SECTION-->
  128. <br>
  129. <a name="ctrl">
  130. <br>
  131. <span class="subhead">ASP+ Server Control Syntax</span>
  132. <p>
  133.  
  134. Custom server controls enable page developers to dynamically generate HTML UI and respond to 
  135. client requests. They are represented within a file using a declarative, tag-based syntax.
  136. These tags are distinguished from other tags because they contain a "runat=server" attribute. 
  137. The below example demonstrates how a <asp:label runat="server"> server control can be
  138. used within an ASP+ Page. This control corresponds to the class Label in the
  139. <nobr>System.Web.UI.WebControls</nobr> namespace, which is included by default.
  140. <p>
  141. By adding a tag with the ID "Message", an instance of Label is created at runtime:
  142.  
  143. <div class="code"><pre>
  144. <asp:label id="Message" font-size=24 runat="server"/>
  145. </pre></div>
  146.  
  147. The control can then be accessed using the same name. The following line sets the Text property
  148. of the control:
  149. <div class="code"><pre>
  150. Message.Text = "Welcome to ASP+";
  151. </pre></div>
  152.  
  153. <Acme:SourceRef
  154.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference3.aspx"
  155.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference3.src"
  156.   Icon="/quickstart/aspplus/images/reference3.gif"
  157.   Caption="Reference3.aspx"
  158.   runat="server" />
  159.  
  160.  
  161.  
  162. <!--BEGIN SECTION-->
  163. <br>
  164. <a name="htmlctrl">
  165. <br>
  166. <span class="subhead">ASP+ Html Server Control Syntax </span>
  167. <p>
  168.  
  169. HTML Server controls enable page developers to programmatically manipulate HTML elements 
  170. within a page.  An HTML server control tag is distinguished from client HTML elements
  171. by means of a "runat=server" attribute.  The below example demonstrates how a HTML 
  172. <span runat=server> server control can be used within an ASP+ Page.
  173. <p>
  174. As with other server controls, the methods and properties are accessible programmatically:
  175. <div class="code"><pre>
  176. <script language="C#" runat=server>
  177.   void Page_Load(Object sender, EventArgs e) {
  178.     Message.InnerHtml = "Welcome to ASP+";
  179.   }
  180. </script>
  181. ...    
  182. <span id="Message" style="font-size:24" runat=server/>
  183. </pre></div>
  184.  
  185. <Acme:SourceRef
  186.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference4.aspx"
  187.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference4.src"
  188.   Icon="/quickstart/aspplus/images/reference4.gif"
  189.   Caption="Reference4.aspx"
  190.   runat="server" />
  191.  
  192.  
  193.  
  194. <!--BEGIN SECTION-->
  195. <br>
  196. <a name="databind">
  197. <br>
  198. <span class="subhead">Databinding Syntax: <%# %> </span>
  199. <p>
  200.  
  201. The DataBinding support built into ASP+ enables page developers to hierarchically bind 
  202. control properties to data container values.  Code located within a <%# %>
  203. code block is only executed when the "DataBind" method of its parent control 
  204. container is invoked.  The below sample demonstrates how to use the databinding 
  205. syntax within a <asp:datalist runat=server> control.
  206. <p>
  207. Within the datalist the template for one item is specified. Container.DataItem refers 
  208. to the data source of the datalist "MyList":
  209. <div class="code"><pre>
  210. <asp:datalist id="MyList" runat=server>
  211.   <template name="ItemTemplate">
  212.     Here is a value: <%# Container.DataItem %>
  213.   </template>
  214. </asp:datalist>
  215. </pre></div>
  216.  
  217. In this case the datasource of the "MyList" control is set programmatically, 
  218. then DataBind() is called:
  219. <div class="code"><xmp>
  220. void Page_Load(Object sender, EventArgs e) {
  221.   ArrayList items = new ArrayList();
  222.  
  223.   items.Add("One");
  224.   items.Add("Two");
  225.   items.Add("Three");
  226.  
  227.   MyList.DataSource = items;
  228.   MyList.DataBind();
  229. }
  230. </xmp></div>
  231.  
  232.  
  233.  
  234.  
  235. <Acme:SourceRef
  236.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference5.aspx"
  237.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference5.src"
  238.   Icon="/quickstart/aspplus/images/reference5.gif"
  239.   Caption="Reference5.aspx"
  240.   runat="server" />
  241.  
  242.  
  243. <!--BEGIN SECTION-->
  244. <br>
  245. <a name="object">
  246. <br>
  247. <span class="subhead">Object Tag Syntax: <object runat="server" /></span>
  248. <p>
  249.  
  250. Object Tags enable page developers to declare and instantiate variables using a declarative, tag-based, syntax. The 
  251. below sample demonstrates how the object tag can be used to instantiate an arraylist class instance:
  252.  
  253. <div class="code"><pre>
  254. <object id="items" class="System.Collections.ArrayList" runat="server"/>
  255. </pre></div>
  256.  
  257. The object will be created autmically at runtime and can then be accessed via the the ID "item":
  258.  
  259. <div class="code"><pre>
  260. void Page_Load(Object sender, EventArgs e) {
  261.   items.Add("One");
  262.   items.Add("Two");
  263.   items.Add("Three");
  264.   ...
  265. }
  266. </div></pre>
  267.  
  268. <p>
  269.  
  270. <Acme:SourceRef
  271.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference6.aspx"
  272.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference6.src"
  273.   Icon="/quickstart/aspplus/images/reference6.gif"
  274.   Caption="Reference6.aspx"
  275.   runat="server" />
  276.  
  277.  
  278. <!--BEGIN SECTION-->
  279. <br>
  280. <a name="comment">
  281. <br>
  282. <span class="subhead">Server Side Comment Syntax: <%-- Comment --%></span>
  283. <p>
  284.  
  285. Server-Side Comments enable page developers to prevent server code (including server controls) and 
  286. static content from executing/rendering.  The below sample demonstrates how to block content from
  287. executing and/or being sent down to a client. Note, that everything between <%-- and --%> is
  288. filtered out and only visible in the original server file, even though it contains other ASP+ 
  289. directives:
  290.  
  291. <div class="code"><pre>
  292. <%--
  293.  
  294.   <asp:calendar id="MyCal" runat=server/>
  295.     <% for (int i=0; i<45; i++) { %>
  296.              Hello World <br>
  297.     <% } %>
  298. --%>
  299. </pre></div>
  300.  
  301.  
  302. <p>
  303.  
  304. <Acme:SourceRef
  305.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference7.aspx"
  306.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference7.src"
  307.   Icon="/quickstart/aspplus/images/reference7.gif"
  308.   Caption="Reference7.aspx"
  309.   runat="server" />
  310.  
  311.  
  312. <!--BEGIN SECTION-->
  313. <br>
  314. <a name="include">
  315. <br>
  316. <span class="subhead">Server Side Include Syntax: <-- #Include File="Locaton.inc" --></span>
  317. <p>
  318.  
  319. Server-Side #Includes enable developers to insert the raw contents of a specified file anywhere 
  320. within an ASP+ Page.  The below sample demonstrates how to insert a custom header and footer within a page:
  321.  
  322. <div class="code"><pre>
  323. <!-- #Include File="Header.inc" -->
  324. ...
  325. <!-- #Include File="Footer.inc" -->
  326. </pre></div>
  327.  
  328. <p>
  329.  
  330. <Acme:SourceRef
  331.   RunSample="/quickstart/aspplus/samples/webforms/reference/reference8.aspx"
  332.   ViewSource="/quickstart/aspplus/samples/webforms/reference/reference8.src"
  333.   Icon="/quickstart/aspplus/images/reference8.gif"
  334.   Caption="Reference8.aspx"
  335.   runat="server" />
  336.  
  337. <!-- #include virtual="/quickstart/aspplus/include/footer.inc" -->