home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 40 / IOPROG_40.ISO / SOFT / NETFrameworkSDK.exe / comsdk.cab / samples.exe / QuickStart / aspplus / doc / webvalidation.aspx < prev    next >
Encoding:
Text File  |  2000-06-11  |  14.2 KB  |  362 lines
  1.  
  2. <%@ Register TagPrefix="Acme" TagName="SourceRef" Src="/quickstart/util/SrcRef.aspx"%>
  3.  
  4. <!-- #include virtual="/quickstart/aspplus/include/header.inc" -->
  5.  
  6. <h4>Server Control Form Validation</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>
  11.     <a class="toc2" target="content" href="#intro">Introduction to Validation</a><br>
  12.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  13.     <a class="toc2" target="content" href="#types">Types of Validation Controls</a><br>
  14.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  15.     <a class="toc2" target="content" href="#client">Client-Side Validation</a><br>
  16.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  17.     <a class="toc2" target="content" href="#errors">Displaying Validation Errors</a><br>
  18.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  19.     <a class="toc2" target="content" href="#compare">Working with CompareValidator</a><br>
  20.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  21.     <a class="toc2" target="content" href="#range">Working with RangeValidator</a><br>
  22.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  23.     <a class="toc2" target="content" href="#regex">Working with Regular Expressions</a><br>
  24.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  25.     <a class="toc2" target="content" href="#custom">Performing Custom Validation</a><br>
  26.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  27.     <a class="toc2" target="content" href="#together">Bringing It All Together</a><br>
  28.     <b> <img align="middle" src="/quickstart/images/bullet.gif">  </b>
  29.     <a class="toc2" target="content" href="#endofsection">Section Summary</a><br>
  30. </div>
  31. <p>
  32. <hr>
  33.  
  34. <!--BEGIN SECTION-->
  35. <a name="intro">
  36. <span class="subhead">Introduction to Validation</span>
  37. <p>
  38. The Web Forms framework provides a set of validation server controls that provide an easy-to-use but powerful way 
  39. to check input forms for errors, and if necessary, display messages to the user.
  40.  
  41. <p>
  42. Validation controls are added to a Web Form like other server controls.  There are controls for specific types of 
  43. validation, such as range checking or pattern matching, plus a RequiredFieldValidator that ensures a user does
  44. not skip an entry field.  You can attach more than one validation control to an input control. For example, you 
  45. might specify that an entry is both required and that it contain a specific range of values.
  46.  
  47. <p>
  48. Validation controls work with a limited subset of HTML and Web server controls.  For each control, a specific 
  49. property contains the value to be validated.  Here are the input controls that may be validated:
  50.  
  51. <p>
  52. <div class="indent">
  53. <table class="table2" width="400" cellpadding="3">
  54.     <tr>
  55.     <th>Control</th>
  56.     <th>Validation Property</th>
  57.     </tr>
  58.     <tr>
  59.     <td><b>HtmlInputText</b></td>
  60.     <td>Value</td>
  61.     </tr>
  62.     <tr>
  63.     <td><b>HtmlTextArea</b></td>
  64.     <td>Value</td>
  65.     </tr>
  66.     <tr>
  67.     <td><b>HtmlSelect</b></td>
  68.     <td>Value</td>
  69.     </tr>
  70.     <tr>
  71.     <td><b>HtmlInputFile</b></td>
  72.     <td>Value</td>
  73.     </tr>
  74.     <tr>
  75.     <td><b>TextBox</b></td>
  76.     <td>Text</td>
  77.     </tr>
  78.     <tr>
  79.     <td><b>ListBox</b></td>
  80.     <td>SelectedItem</td>
  81.     </tr>
  82.     <tr>
  83.     <td><b>DropDownList</b></td>
  84.     <td>SelectedItem</td>
  85.     </tr>
  86.     <tr>
  87.     <td><b>RadioButtonList</b></td>
  88.     <td>SelectedItem</td>
  89.     </tr>
  90. </table> 
  91. </div>
  92.  
  93. <!--BEGIN SECTION-->
  94. <br>
  95. <a name="types">
  96. <br>
  97. <span class="subhead">Types of Validation Controls</span>
  98. <p>
  99. The simplest form of validation is a <b>required field</b>.  If the user inputs any value into a field, it is valid.  
  100. If all of the fields in the page are valid, the page is valid.  This example illustrates using the RequiredFieldValidator.
  101.  
  102. <p>
  103. <!-- server side required field -->
  104. <Acme:SourceRef
  105.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator1.aspx"
  106.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator1.src"
  107.   Icon="/quickstart/aspplus/images/validator1.gif"
  108.   Caption="Validator1.aspx"
  109.   runat="server" />
  110.  
  111. <p>
  112. There are also validation controls for specific types of validation, such as range checking or pattern matching.  
  113. This is the complete list:
  114.  
  115. <p>
  116. <div class="indent">
  117. <table class="table2" width="80%" cellpadding=3>
  118.     <tr>
  119.     <th>Control Name</th>
  120.     <th>Description</th>
  121.     </tr>
  122.     <tr>
  123.     <td style="width:25%"><b>RequiredFieldValidator</b></td>
  124.     <td>Ensures that the user does not skip an entry.</td>
  125.     </tr>
  126.     <tr>
  127.     <td style="width:25%"><b>CompareValidator</b></td>
  128.     <td>Compares a user's entry against a constant value or a property value of another control using a comparison operator (less than, equal, greater than, and so on).</td>
  129.     </tr>
  130.     <tr>
  131.     <td style="width:25%"><b>RangeValidator</b></td>
  132.     <td>Checks that a user's entry is between specified lower and upper boundaries. You can check ranges within pairs of numbers, alphabetic characters, and dates. Boundaries can be expressed as constants or as values derived from another control.</td>
  133.     </tr>
  134.     <tr>
  135.     <td style="width:25%"><b>RegularExpressionValidator</b></td>
  136.     <td>Checks that the entry matches a pattern defined by a regular expression. This type of validation allows you to check for predictable sequences of characters, such as those in social security numbers, e-mail addresses, telephone numbers, postal codes, and so on.</td>
  137.     </tr>
  138.     <tr>
  139.     <td style="width:25%"><b>CustomValidator</b></td>
  140.     <td>Checks the user's entry using validation logic that you code yourself. This type of validation allows you to check for values derived at run time.</td>
  141.     </tr>
  142.     <tr>
  143.     <td style="width:25%"><b>ValidationSummary</b></td>
  144.     <td>Displays the validation errors in summary form for all of the validators on a page.</td>
  145.     </tr>
  146. </table> 
  147. </div>
  148.  
  149.  
  150. <!--BEGIN SECTION-->
  151. <br>
  152. <a name="client">
  153. <br>
  154. <span class="subhead">Client-Side Validation</span>
  155. <p>
  156. The validation controls always perform validation checking in server code. However, if the user is working 
  157. with a browser that supports DHTML, the validation controls can also perform validation using client script. 
  158. With client-side validation, errors are detected immediately and error messages are displayed as soon as the 
  159. form field containing the error loses focus. This permits the user to correct his input prior to submitting 
  160. the form to the server. 
  161.  
  162. <p>
  163. Note that the Web Forms framework always performs validation on the server, even if the validation has 
  164. already been performed on the client.  This helps prevent users from being able to bypass validation by 
  165. impersonating another user or a pre-approved transaction.
  166.  
  167. <p>
  168. Client-side validation is enabled by default.  If the client is capable, then uplevel validation will be performed automatically.  
  169. To disable client-side validation, set the page's ClientTarget property to "Downlevel" ("Uplevel" forces client-side validation).
  170.  
  171. <p>
  172. <!-- client-side required field -->
  173. <Acme:SourceRef
  174.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator2.aspx"
  175.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator2.src"
  176.   Icon="/quickstart/aspplus/images/validator2.gif"
  177.   Caption="Validator2.aspx"
  178.   runat="server" />
  179.  
  180. <!--BEGIN SECTION-->
  181. <br>
  182. <a name="errors">
  183. <br>
  184. <span class="subhead">Displaying Validation Errors</span>
  185. <p>
  186. When the user's input is processed (for example, when the form is submitted), the Web Forms framework passes 
  187. the user's entry to the associated validation control or controls. The validation controls test the user's input 
  188. and set a property to indicate whether the entry passed the validation test. After all validation controls have 
  189. been processed, the <b>IsValid</b> property on the page is set; if any of the controls shows 
  190. that a validation check failed, the entire page is set to invalid.
  191. <p>
  192.  
  193. <p>
  194. If a validation control is in error, an error message may be displayed in the page by the validation control or 
  195. in a ValidationSummary control elsewhere on the page.  The ValidationSummary control is displayed 
  196. when the IsValid property of the page is false.  It "polls" each of the validation controls on the page and 
  197. aggregates the text messages exposed by each.  This example illustrates displaying errors with 
  198. a ValidationSummary.
  199.  
  200. <p>
  201. <!--ValidationSummary-->
  202. <Acme:SourceRef
  203.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator3.aspx"
  204.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator3.src"
  205.   Icon="/quickstart/aspplus/images/validator3.gif"
  206.   Caption="Validator3.aspx"
  207.   runat="server" />
  208.  
  209.  
  210. <!--BEGIN SECTION-->
  211. <br>
  212. <a name="compare">
  213. <br>
  214. <span class="subhead">Working with CompareValidator</span>
  215. <p>
  216. The CompareValidator server control compares the values of two controls.  CompareValidator uses three key properties to perform its validation.  <b>ControlToValidate</b> and <b>ControlToCompare</b> 
  217. contain the values to compare.  <b>Operator</b> defines the type of comparison to perform, for example, Equal or Not 
  218. Equal.  CompareValidator performs the validation by evaluating these properties as an expression:
  219. <xmp>   ( ControlToValidate <Operator> ControlToCompare ) </xmp>
  220.  
  221. If the expression evaluates true, the validation result is valid.
  222.  
  223. <p>
  224. This sample illustrates using the CompareValidator control.
  225.  
  226. <p>
  227. <!--CompareVal-->
  228. <Acme:SourceRef
  229.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator4.aspx"
  230.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator4.src"
  231.   Icon="/quickstart/aspplus/images/validator4.gif"
  232.   Caption="Validator4.aspx"
  233.   runat="server" />
  234.  
  235.  
  236. <!--BEGIN SECTION-->
  237. <br>
  238. <a name="range">
  239. <br>
  240. <span class="subhead">Working with RangeValidator</span>
  241. <p>
  242. The RangeValidator server control tests whether an input value falls within a given range.  
  243. RangeValidator uses three key properties to perform its validation.  <b>ControlToValidate</b> contains the value 
  244. to validate.  <b>MinimumControl</b> and <b>MaximumControl</b> define the minimum and maximum values of the valid 
  245. range.  
  246.  
  247. <p>
  248. This sample illustrates using the RangeValidator control.
  249.  
  250. <p>
  251. <!-- RangeVal -->
  252. <Acme:SourceRef
  253.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator5.aspx"
  254.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator5.src"
  255.   Icon="/quickstart/aspplus/images/validator5.gif"
  256.   Caption="Validator5.aspx"
  257.   runat="server" />
  258.  
  259.  
  260. <!--BEGIN SECTION-->
  261. <br>
  262. <a name="regex">
  263. <br>
  264. <span class="subhead">Working with Regular Expressions</span>
  265. <p>
  266. The RegularExpressionValidator server control checks that the entry matches a pattern defined by a 
  267. regular expression. This type of validation allows you to check for predictable sequences of characters, 
  268. such as those in social security numbers, e-mail addresses, telephone numbers, postal codes, and so on.
  269.  
  270. <p>
  271. RegularExpressionValidator uses two key properties to perform its validation.  <b>ControlToValidate</b> contains 
  272. the value to validate.  <b>ValidationExpression</b> contains the regular expression to match.
  273.  
  274. <p>
  275. These samples illustrates using the RegularExpressionValidator control.
  276.  
  277. <p>
  278. <!-- regex -->
  279. <Acme:SourceRef
  280.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator6.aspx"
  281.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator6.src"
  282.   Icon="/quickstart/aspplus/images/validator6.gif"
  283.   Caption="Validator6.aspx"
  284.   runat="server" />
  285.  
  286. <p>
  287. <!-- more regex-->
  288. <Acme:SourceRef
  289.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator7.aspx"
  290.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator7.src"
  291.   Icon="/quickstart/aspplus/images/validator7.gif"
  292.   Caption="Validator7.aspx"
  293.   runat="server" />
  294.  
  295.  
  296. <!--BEGIN SECTION-->
  297. <br>
  298. <a name="custom">
  299. <br>
  300. <span class="subhead">Performing Custom Validation</span>
  301. <p>
  302. The CustomValidator server control calls a user-defined function to perform validations that the standard 
  303. validators can't handle.  The custom function can execute on the server or in client-side script, such as JScript or VBScript.  
  304. For client-side custom validation, the name of the custom function must be identified in the <b>ClientValidationFunction</b> 
  305. property.  The custom function must have the form:
  306. <xmp>   function myvalidator(source, value)</xmp>
  307. Note that <b>source</b> is the client-side CustomValidator object, and <b>value</b> is the value to be validated.
  308.  
  309. <p>
  310.  
  311. For server-side custom validation, place your custom validation in the validator's <b>OnServerValidationFunction</b> 
  312. delegate.  
  313.  
  314. <p>
  315. These samples illustrate using the CustomValidator control.
  316.  
  317.  
  318. <p>
  319. <!-- custom -->
  320. <Acme:SourceRef
  321.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator8.aspx"
  322.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator8.src"
  323.   Icon="/quickstart/aspplus/images/validator8.gif"
  324.   Caption="Validator8.aspx"
  325.   runat="server" />
  326.  
  327. <!--BEGIN SECTION-->
  328. <br>
  329. <a name="together">
  330. <br>
  331. <span class="subhead">Bringing It All Together</span>
  332. <p>
  333. This sample shows a typical registration form, using the variations of validation controls we've discussed so far.
  334. <p>
  335. <!-- summary -->
  336. <Acme:SourceRef
  337.   RunSample="/quickstart/aspplus/samples/webforms/validate/validator9.aspx"
  338.   ViewSource="/quickstart/aspplus/samples/webforms/validate/validator9.src"
  339.   Icon="/quickstart/aspplus/images/validator9.gif"
  340.   Caption="Validator9.aspx"
  341.   runat="server" />
  342.  
  343.  
  344.  
  345. <!--BEGIN SECTION-->
  346. <a name="endofsection">
  347.  
  348. <h4>Section Summary</h4>
  349. <ol>
  350. <li>Validator controls can be used to validate input on any Web Form.
  351. <li>More than one control can be used on a given input field.
  352. <li>Client-side validation may be used in addition to server validation to improve form usability.
  353. <li>The CustomValidator control lets the user define custom validation criteria.
  354. </ol>
  355. <p>
  356.  
  357. <!-- #include virtual="/quickstart/aspplus/include/footer.inc" -->
  358.  
  359.  
  360.  
  361.  
  362.