|
About VControls:
ASPSmith VControls are a suite of Validated
Controls that can be dragged and dropped onto forms to quickly create validated
form elements for common form items. By using these controls, the amount of
code required for any given form item is reduced significantly, usually cutting
4 or more lines of code down to one. Further, since these controls have already
been tested, the time spent debugging and coming up with validation logic is
significantly reduced as well. Finally, the controls are completely
customizable and extensible, so no flexibility is lost by using these controls
in your applications. By using the web.config file to set up the default behavior for
VControls in your application, you can eliminate even the need to custom configure the
controls on each page unless the control really is different from your standard usage.
Current Features:
- ASP.NET Beta 2 Compliant
- Visual Studio.NET Beta 2 Compliant
- Completely configurable via web.config file
- MX Record Lookup validation for Email addresses
- Multiple validation formats supported natively or write your own regular expression
- Easily fits into your form's user interface
- Complete XML/HTML documentation provided
- Working Demo Pages provided
- Subclass and extend the controls to create your own
Supported Form Items
Validated TextBox Controls:
- CreditCardBox (one or more formats)
- EmailBox
- NumberBox (one or more formats)
- PhoneBox (one or more formats)
- PostalCodeBox (one or more formats)
- SsnBox (one or more formats)
- UrlBox (one or more formats)
- ZipBox (subclass of PostalCodeBox)
Validated DropDownList Controls:
-
Coming Soon!
Version History:
-
Version 0.1.614.26042 - 6 September 2001
-
Version 0.1.593.41701 - 17 August 2001
Usage:
Visual Studio.NET integration is not yet done automatically. Right now the
easiest way to use these controls is to follow the following simple steps:
-
Copy the ASPSmith.VControls.dll to your application's bin folder.
-
Add the following line to your ASP.NET page:
<%@ Register TagPrefix="ASPSmith" Namespace="ASPSmith.VControls"
Assembly="ASPSmith.VControls" %>
-
Refer to the controls using the ASPSmith prefix followed by the name of the
control. For example:
<ASPSmith:EmailBox id="Email" runat="server"
SeparatorHtml="</td><td>" IsRequired="True" />
Note the use of the SeparatorHtml field -- this is what will be placed between
the textbox and the validator controls, and is most often an ending table cell
tag and an opening table cell tag, as you can see in the line above. This would
place the text box and the validators in separate columns of a table (as you
can see at the bottom of this page).
Default Settings
Starting with version 0.1.614.26042, the VControls support the use of settings in the web.config file to establish defaults
for the common properties of all of the controls. If the default implementation of a VControl is not what you would prefer,
and you are going to use the control more than once in your application, you can easily configure the control to default to
the behavior you prefer by adding some nodes to your web.config file. Included with the download is a sample web.config file
that includes all of the possible settings for all of the controls. To use this, simply cut and paste what you need, including
the XML hierarchy, into your web.config file. Don't forget that you will need to include the entire
<sectionGroup name="VControls"> section, which should go in a sectionGroup node (which you can also cut and paste if you
don't already have one in your web.config).
Common Properties:
The VControls all inherit from a VControl class, which in turn inherits from
the Control class, which is built into the .NET Framework. The TextBox
controls, in turn, all inherit from the VTextBox class. This class can easily
be extended to cover other TextBox form fields that you may need within your
organization or application. Here are the exposed methods and properties of
VTextBox: (coming soon - for now see the XML documentation at
VControls.xml or view the assembly using VS.NET or
Lutz Roeder's .NET Desktop Object Browser
|
Property |
Description |
|
|
|
Method |
Description |
Download:
You can download the latest version of the VControls Suite from the following
URL:
http://aspsmith.com/vcontrols/
Known Bugs:
None.
Planned Enhancements
-
Full VS.NET Integration.
-
Web.Config configuration for default values.
-
Optional MX record lookup for email validation.
-
Optional HTTP lookup for URL validation.
-
International Phone Options.
-
States DropDownList (US and other countries), with or without abbreviations,
with optional web service for updates.
-
Countries DropDownList, with or without abbreviations, with optional web
service for updates.
-
Month DropDownList, with numeric, abbreviation, full name options (for credit
card expiration dates)
-
Year DropDownList (for credit card expiration dates)
-
Gender DropDownList
-
MaritalStatus DropDownList
-
Number (optionally positive, negative, integer, float)
-
Money (special case of Number)
-
Password
Feedback:
Please send all bugs, feedback, and feature requests to
training@aspsmith.com.
|