DNAide Wiki & Documentation Rss Feed

UPDATED WIKI: Home

stebrennan — Sun, 30 Dec 2007 09:28:23 GMT

DNAide (.NET Aide)

http://www.dnaide.com

DNAide is a FREE suite of .NET 2.0. helper controls and methods that are here to make your ASP.NET development easier.

By using DNAide within your ASP.NET websites you will have access to:

Image Manipulation

Resizing, cropping and more advanced filters and effects such as blur, sharpen, greyscale, pixellate etc.
Dynamic text based images. DNAide will generate dynamic text based images for you and can even be used as an image replacement technique for content in your XHTML tags.

Friendly URLs and Sitemap Enhancements

A handy URL rewriting module for making your website's URLs user friendly and memorable; all of which can help your website's SEO (Search Engine Optimisation) strategy!
As well as standard url rewriting features (regular expression pattern matching, rewriting, permanent redirects, temporary redirects etc.), what makes DNAide's rewriter stand out from the crowd is the integration with ASP.NET 2.0.'s sitemap functionality. Through additional sitemap node attributes, you can define rewriting / redirect rules. For example, in theory you could run your site may run off one .aspx webform. Via your sitemap, you can specify your website structure and unique page urls with each page rewritten to the one .aspx webform.

Javascript & CSS

Automatically compress your .js files!
Improves upon Page.ReisterClientScriptBlock, you can register your JavaScript includes/blocks of script in the head of your XHTML output as well as any other location in your page.
DNAide comes complete with a number of built in JavaScript resources such as jQuery, SWFObject as well as custom built scripts for image preloading, ValidationAide (form validation) and AJAXAide to name a few.
As well as ScriptAide, DNAide also includes a complimentary StyleAide which is used for registering cascading stylesheets etc.

Other Nice Stuff

DNAide provides a number of other useful controls and functions including:

Additional controls such as "FlashMovie" (a webcontrol for embedding your flash movies using SWFObject) and Hyperlink Pager.
A number of "plumbing" methods easing such things as type conversion, string manipulation methods etc.

For more information, please visit http://www.dnaide.com

UPDATED WIKI: Home

stebrennan — Sun, 09 Dec 2007 22:41:31 GMT

DNAide (.NET Aide)

Resizing, cropping and more advanced filters and effects such as blur, sharpen, greyscale, pixellate etc.
Dynamic text based images. DNAide will generate dynamic text based images for you and can even be used as an image replacement technique for content in your XHTML tags.

Friendly URLs and Sitemap Enhancements

A handy URL rewriting module for making your website's URLs user friendly and memorable; all of which can help your website's SEO (Search Engine Optimisation) strategy!
As well as standard url rewriting features (regular expression pattern matching, rewriting, permanent redirects, temporary redirects etc.), what makes DNAide's rewriter stand out from the crowd is the integration with ASP.NET 2.0.'s sitemap functionality. Through additional sitemap node attributes, you can define rewriting / redirect rules. For example, in theory you could run your site may run off one .aspx webform. Via your sitemap, you can specify your website structure and unique page urls with each page rewritten to the one .aspx webform. In fact, this is how this website is structured!

Javascript & CSS

Automatically compress your .js files!
Improves upon Page.ReisterClientScriptBlock, you can register your JavaScript includes/blocks of script in the head of your XHTML output as well as any other location in your page.
DNAide comes complete with a number of built in JavaScript resources such as jQuery, SWFObject as well as custom built scripts for image preloading, ValidationAide (form validation) and AJAXAide to name a few.
As well as ScriptAide, DNAide also includes a complimentary StyleAide which is used for registering cascading stylesheets etc.

Other Nice Stuff

DNAide provides a number of other useful controls and functions including:

Additional controls such as "FlashMovie" (a webcontrol for embedding your flash movies using SWFObject) and Hyperlink Pager.
A number of "plumbing" methods easing such things as type conversion, string manipulation methods etc.

For more information, please visit http://www.dnaide.com

UPDATED WIKI: Home

stebrennan — Sun, 09 Dec 2007 22:40:52 GMT

DNAide (.NET Aide)

Resizing, cropping and more advanced filters and effects such as blur, sharpen, greyscale, pixellate etc.
Dynamic text based images. DNAide will generate dynamic text based images for you and can even be used as an image replacement technique for content in your XHTML tags.

Friendly URLs and Sitemap Enhancements

A handy URL rewriting module for making your website's URLs user friendly and memorable; all of which can help your website's SEO (Search Engine Optimisation) strategy!
As well as standard url rewriting features (regular expression pattern matching, rewriting, permanent redirects, temporary redirects etc.), what makes DNAide's rewriter stand out from the crowd is the integration with ASP.NET 2.0.'s sitemap functionality. Through additional sitemap node attributes, you can define rewriting / redirect rules. For example, in theory you could run your site may run off one .aspx webform. Via your sitemap, you can specify your website structure and unique page urls with each page rewritten to the one .aspx webform. In fact, this is how this website is structured!

Javascript & CSS

Automatically compress your .js files!
Improves upon Page.ReisterClientScriptBlock, you can register your JavaScript includes/blocks of script in the head of your XHTML output as well as any other location in your page.
DNAide comes complete with a number of built in JavaScript resources such as jQuery, SWFObject as well as custom built scripts for image preloading, ValidationAide (form validation) and AJAXAide to name a few.
As well as ScriptAide, DNAide also includes a complimentary StyleAide which is used for registering cascading stylesheets etc.

Other Nice Stuff

DNAide provides a number of other useful controls and functions including:

Additional controls such as "FlashMovie" (a webcontrol for embedding your flash movies using SWFObject) and Hyperlink Pager.
A number of "plumbing" methods easing such things as type conversion, string manipulation methods etc.

For more information, please visit http://www.dnaide.com

UPDATED WIKI: Home

stebrennan — Mon, 28 May 2007 14:49:44 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net 2.0 developers.

New Blog Created!
In addition to the documentation below, check here for articles on how best to use and get the most out of DNAide.
http://dnaide.blogspot.com

Key Features
Include (amongst others):

DNAide.Drawing

CreateTextImage - Dynamic "Header Text" image.

Throw this some text, color, font, and various configuration options (such as font-smoothing etc) to generate text images on the fly.

CreateThumbNail - Image thumbnail generator.

Produces quality thumbnails - far superior GIF thumbnails than GDI default.
Works with JPEG and GIF.
Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur

DNAide.Web

UrlRewriter - Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

DNAideXmlSiteMapProvider - Useful extensions to the standard XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a "build sitemap file" method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

UrlAide - Handy Url based aides including:

Resolve - resolve a url to include full application path. Works with "~/"
MakeUrlSafe - Useful for generating friendly urls from such items as products, news stories etc stored in a database.
ChangeQueryStringValueInUrl - Given a url string, allows you to change the value of querystring parameter.

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag

Also includes a number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx.

Validation - Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling
StyleAide - Register your CSS in a XHTML page's <head>
Additional WebControls

HyperLinkPager
ServerMessage
FlashMovie
ActiveX

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

Please note, DNAide does not provide any data access / O/R helpers etc. We recommend using the excellent SubSonic (http://www.codeplex.com/actionpack) project together with DNAide.

Important This WIKI does not document all features. However, key features and examples are provided. More complete documentation to follow.

UPDATED WIKI: Home

stebrennan — Mon, 28 May 2007 14:22:23 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net developers. Features include (amongst others):

DNAide.Drawing

CreateTextImage - Dynamic "Header Text" image.

Throw this some text, color, font, and various configuration options (such as font-smoothing etc) to generate text images on the fly.

CreateThumbNail - Image thumbnail generator.

Produces quality thumbnails - far superior GIF thumbnails than GDI default.
Works with JPEG and GIF.
Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur

DNAide.Web

UrlRewriter - Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

DNAideXmlSiteMapProvider - Useful extensions to the standard XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a "build sitemap file" method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

UrlAide - Handy Url based aides including:

Resolve - resolve a url to include full application path. Works with "~/"
MakeUrlSafe - Useful for generating friendly urls from such items as products, news stories etc stored in a database.
ChangeQueryStringValueInUrl - Given a url string, allows you to change the value of querystring parameter.

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag

Also includes a number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx.

Validation - Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling
StyleAide - Register your CSS in a XHTML page's <head>
Additional WebControls

HyperLinkPager
ServerMessage
FlashMovie
ActiveX

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

UPDATED WIKI: Home

stebrennan — Mon, 28 May 2007 14:21:33 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net developers. Features include (amongst others):

DNAide.Drawing

CreateTextImage - Dynamic "Header Text" image.

Throw this some text, color, font, and various configuration options (such as font-smoothing etc) to generate text images on the fly.

CreateThumbNail - Image thumbnail generator.

Produces quality thumbnails - far superior GIF thumbnails than GDI default.
Works with JPEG and GIF.
Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur

DNAide.Web

UrlRewriter - Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

DNAideXmlSiteMapProvider - Useful extensions to the standard XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a "build sitemap file" method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

UrlAide - Handy Url based aides including:

Resolve - resolve a url to include full application path. Works with "~/"
MakeUrlSafe - Useful for generating friendly urls from such items as products, news stories etc stored in a database.
ChangeQueryStringValueInUrl - Given a url string, allows you to change the value of querystring parameter.

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag

Also includes a number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx.

Validation - Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling
StyleAide - Register your CSS in a XHTML page's <head>
Additional WebControls

HyperLinkPager
ServerMessage
FlashMovie
ActiveX

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

UPDATED WIKI: Home

stebrennan — Mon, 28 May 2007 14:01:08 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net developers. Features include (amongst others):

DNAide.Drawing

CreateTextImage - Dynamic "Header Text" image.

Throw this some text, color, font, and various configuration options (such as font-smoothing etc) to generate text images on the fly.

CreateThumbNail - Image thumbnail generator.

Produces quality thumbnails - far superior GIF thumbnails than GDI default.
Works with JPEG and GIF.
Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur

DNAide.Web

UrlRewriter - Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

DNAideXmlSiteMapProvider - Useful extensions to the standard XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a "build sitemap file" method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

UrlAide - Handy Url based aides including:

Resolve - resolve a url to include full application path. Works with "~/"
MakeUrlSafe - Useful for generating friendly urls from such items as products, news stories etc stored in a database.
ChangeQueryStringValueInUrl - Given a url string, allows you to change the value of querystring parameter.

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag

Also includes a number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx.

Validation - Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling
StyleAide - Register your CSS in a XHTML page's <head>
Additional WebControls

HyperLinkPager
ServerMessage
FlashMovie
ActiveX

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

Important This WIKI does not document all features. However, key features and examples are provided. More complete documentation to follow.

UPDATED WIKI: Home

stebrennan — Mon, 28 May 2007 13:59:52 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net developers. Features include (amongst others):

DNAide.Drawing

CreateTextImage - Dynamic "Header Text" image.

Throw this some text, color, font, and various configuration options (such as font-smoothing etc) to generate text images on the fly.

CreateThumbNail - Image thumbnail generator.

Produces quality thumbnails - far superior GIF thumbnails than GDI default.
Works with JPEG and GIF.
Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur

DNAide.Web

UrlRewriter - Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

DNAideXmlSiteMapProvider - Useful extensions to the standard XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a "build sitemap file" method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

UrlAide - Handy Url based aides including:

Resolve - resolve a url to include full application path. Works with "~/"
MakeUrlSafe - Useful for generating friendly urls from such items as products, news stories etc stored in a database.
ChangeQueryStringValueInUrl - Given a url string, allows you to change the value of querystring parameter.

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag

Also includes a number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx. * Validation - Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling

StyleAide - Register your CSS in a XHTML page's <head>
Additional WebControls

HyperLinkPager
ServerMessage
FlashMovie
ActiveX

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

Important This WIKI does not document all features. However, key features and examples are provided. More complete documentation to follow.

UPDATED WIKI: Home

stebrennan — Sun, 27 May 2007 22:51:27 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net developers. Features include (amongst others):

DNAide.Drawing

CreateTextImage - Dynamic "Header Text" image.

Throw this some text, color, font, and various configuration options (such as font-smoothing etc) to generate text images on the fly.

CreateThumbNail - Image thumbnail generator.

Produces quality thumbnails - far superior GIF thumbnails than GDI default.
Works with JPEG and GIF.
Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur

DNAide.Web

UrlRewriter - Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

DNAideXmlSiteMapProvider - Useful extensions to the standarf XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a "build sitemap file" method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

UrlAide - Handy Url based aides including:

Resolve - resolve a url to include full application path. Works with "~/"
MakeUrlSafe - Useful for generating friendly urls from such items as products, news stories etc stored in a database.
ChangeQueryStringValueInUrl - Given a url string, allows you to change the value of querystring parameter.

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag

Also includes a number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx. * Validation - Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling

StyleAide - Register your CSS in a XHTML page's <head>
Additional WebControls

HyperLinkPager
ServerMessage
FlashMovie
ActiveX

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

Important This WIKI does not document all features. However, key features and examples are provided. More complete documentation to follow.

UPDATED WIKI: DNAide.Web.UI

stebrennan — Sun, 27 May 2007 19:27:06 GMT

UPDATED WIKI: StyleAide

stebrennan — Sun, 27 May 2007 19:26:10 GMT

StyleAide

// Register included css
StyleAide.CurrentContext.RegisterInclude("Screen", UrlAide.Resolve("~/_client/styles/screen.css"));
 
// Register css block
StyleAide.CurrentContext.RegisterBlock("ie", string.Format("<!--[if lte IE 7]><link href=\"{0}\" rel=\"stylesheet\" type=\"text/css\" media=\"screen\" /><![endif]-->", UrlAide.Resolve("~/_client/styles/ie.css")), "screen", false);

UPDATED WIKI: ScriptAide

stebrennan — Sun, 27 May 2007 19:24:41 GMT

ScriptAide

Register your client script so that it is rendered in the <head> of a document rather than in the default .NET <form> tag. Typically used in master pages.

// Register included script
ScriptAide.CurrentContext.RegisterInclude("MyScripts", UrlAide.Resolve("~/js/my-scripts.js"));
 
// Register script block
ScriptAide.CurrentContext.RegisterBlock("SayHello", "<script type=\"text/javascript\">alert('Hello!');</script>", false);

Built in JavaScript Libraries

DNAide include a number of JavaScript libraries embedded as resources. These include:

jQuery (and a number of jQuery extensions)
SwfObject
ActiveXObject (based on SwfObject)

Helper methods are supplied so you can easily use these in your website:

ScriptAide.CurrentContext.RegisterDNAideScriptResource
ScriptAide.GetDNAideScriptResourceUrl

// Register jQuery in a document's <head>
ScriptAide.CurrentContext.RegisterDNAideScriptResource(DNAideScriptResource.JQuery);

UPDATED WIKI: DNAide.Web.UI

stebrennan — Sun, 27 May 2007 19:20:01 GMT

UPDATED WIKI: Home

stebrennan — Sun, 27 May 2007 19:18:12 GMT

DNAide (.NET Aide)

A framework of useful helper (aide) methods principally targeting asp.net developers.

Features include (amongst others)

DNAide.Drawing

Dynamic "Header Text" image. Throw this some text, color, font, and various configuration options to generate text images on the fly.
Image thumbnail generator - produces fantastic quality thumbnails - far superior GIF thumbnails than GDI default. Works with JPEG and GIF. Includes the ability to apply the following image effects: grayscale, negative, sharpen and blur
DNAide.Drawing

DNAide.Web

Simple to use UrlRewriter (for friendly Urls)

Flexible / configurable rules defined in the web.config
No need to define rules in the web.config, it can be integrated into your sitemap file.
Can be configured to move the ViewState to the bottom of your form - for improved SEO purposes.

Useful extensions to the XmlSiteMapProvider

The ability to set the "key" attribute
Rewriting extensions (see above)
Exposes a build sitemap file method. A simple way to generate your own Xml sitemap file from other sources e.g. SQLServer etc.

DNAide.Web

DNAide.Web.UI

ScriptAide - Register your client scripts in a XHTML page's <head> rather than in the <form> tag
A number of key JavaScript libraries as embedded resources - such as jQuery, SWFObject. Includes a simple helper class to access and include these in your aspx * Simple jQuery based client side validation - simply by setting an input's css class attibute! Also a useful pattern for general business rule handling
StyleAide - Register your CSS in a XHTML page's <head>
Additional developer web controls including ActiveX, SWF Flash
DNAide.Web.UI

DNAide.Core

A number of useful core aide methods including:

Type casting for core types such as String, Int, DateTime with the ability to return definable default values on conversion failure.
Additional String helpers

Substring: "Left", "Right", "Mid", "Truncate"
Password generation: Easy to generate configurable strength passwords
Hash Encryption.
Strip from string: StripXml, StripMSWordHtml, StripNonAlphaNumericCharacters

Numeric helpers

DNAide.Collections

DictionaryAide - Allows you to serialize objects implementing the IDictionary interface
ListAide, QueueAide, StackAide - Returns a string based collection from a delimetered string value

Important This WIKI does not document all features. However, key features and examples are provided. More complete documentation to follow.

UPDATED WIKI: Additional WebControls

stebrennan — Sat, 10 Mar 2007 11:58:10 GMT

Additional WebControls

Please note that none of these controls contain a designer interface.

FlashMovie. Renders Html to include a flash movie using SwfObject - http://blog.deconcept.com/swfobject/
ActiveX. Similar to FlashMovie, but for ActiveX controls.
HyperLinkPager. Record pager - with each item being a Url / link rather than a postback button.
ServerMessage. See Validation.

UPDATED WIKI: Validation

stebrennan — Sat, 10 Mar 2007 11:57:07 GMT

Validation

DNAide includes a number of components for improving validation:

ValidationError and ValidationException
ServerMessage WebControl - a simple webcontrol that renders a message into as a div with a "error, warning or normal css class". Also works with ValidationError to display a list of validation errors.
Simple jQuery client validation library

Pattern

Generally, I avoid using the built in .NET validation controls. As a personal preference I prefer the following pattern:

Define an object / controller. This typically maps to a database table and exposes methods for saving etc.
The object / controller ensures that all business rules are correct before saving.
The object / controller throws a ValidationException if any business rule has failed. The ValidationException contains a list of ValidationErrors.
Client displays and error message and a list of what rules have failed.

In addition, the client contains simple JavaScript validation to catch such things as required field, email address format etc.

e.g.

Object / Controller

public static class NewsController
{
	public static int Save(News objectToSave)
	{
		CheckBusinessRules(objectToSave);
		
		objectToSave.Save(auditUserName);
		return objectToSave.NewsId;
	}
 
	private static void CheckBusinessRules(News objectToValidate)
	{
		List<ValidationError> errors = new List<ValidationError>();
		objectToValidate.Headline = StringAide.StripXmlAndTrim(objectToValidate.Headline, 255);
		if (objectToValidate.Headline.Length < 1)
		{
			errors.Add(new ValidationError(string.Empty, string.Empty, 1, "Headline required"));
		}
 
		if (errors.Count > 0)
		{
			throw new ValidationException(errors);
		}
	}
}

ASPX codebehind

private void SaveRecord()
{
	try
	{
		News newsToSave = new News();
		newsToSave.Headline = txtHeadline.Text;
			
		int retval = newsToSave.Save(_currentRecord, "Admin", OriginalModifiedOn);
		Response.Redirect("record-updated.aspx");
	}
	catch (ValidationException ex)
	{
		// Write a bulletted list of server errors using the DNAide ServerMessage control
		FormServerMessage.SetMessage("Please correct the following", ex.ValidationErrors, ServerMessage.MessageDisplayType.Error);
	}	
}

ASPX

<html>
<head>
	// jQuery registered.
	// jQuery StringAide registered
	// jQuery ValidationAide registered
	
	<script type="text/javascript">
	$(document).ready(function() {
		$("#MyForm").validationAideEnable();		
	}
	</script>
</head>
<body>
<form runat="server" id="MyForm">
	<DNAide:ServerMessage ID="FormServerMessage" runat="server" />
	<asp:TextBox ID="txtHeadline" runat="server" CssClass="validator-required" title="Headline required" />
 
	// Submit buttons etc...
</form>
</body>

The jQuery Validation library includes a number of validation rules by default such as required, email address validation etc.

You can add your own validation rules e.g.

<script type="text/javascript">
$(document).ready(function() {
	var rules = $.validationAide.getDefaultValidationRules();
	rules.add('validator-custom', 'Value required - custom', function(v, elm, jQueryElm) {
		if (v == "") return false;
		return true;
	});
	$("#MyForm").validationAideEnable(rules);		
}
</script>

Then to use:

<asp:TextBox ID="txtHeadline" runat="server" CssClass="validator-custom" title="Headline required" />

You can chain rules by simply adding more css classes:

<asp:TextBox ID="txtHeadline" runat="server" CssClass="validator-required validator-custom" title="Headline required" />

You can enable and disable valiation on Html element events:

$("#SaveBtn").validationAideEnableOnClick("#MyForm");
$("#CancelBtn").validationAideDisableOnClick("#MyForm");

When enabling client validation, there are a number of configurable options:

hideErrorMessages: Hides the inline error message
showSpeed: How fast the error messages are faded in
summaryContainerId: The id of the html element to show error summary. Typically a DIV at the top of a form

$("#SaveBtn").validationAideEnableOnClick("#MyForm", {hideErrorMessages:true,showSpeed:'slow'});

UPDATED WIKI: JavaScript Libraries

stebrennan — Sat, 10 Mar 2007 11:56:11 GMT

JavaScript Libraries

DNAide include a number of JavaScript libraries embedded as resources. These include:

jQuery (and a number of jQuery extensions)
SwfObject
ActiveXObject (based on SwfObject)

Helper methods are supplied so you can easily use these in your website:

ScriptResourcesAide.RegisterHeadScriptResource
ScriptResourcesAide.GetScriptResourceUrl

// Register jQuery in a document's <head>
ScriptResourcesAide.RegisterHeadScriptResource(ScriptResourceType.JQuery);

UPDATED WIKI: HeadScriptManager

stebrennan — Sat, 10 Mar 2007 11:55:21 GMT

HeadScriptManager

Register your client script so that it is rendered in the <head> of a document rather than in the defalt .NET <form> tag. Typically used in master pages.

// Register included script
HeadScriptManager.Current.RegisterHeadScriptInclude("MyScripts", UrlAide.Resolve("~/js/my-scripts.js"));
 
// Register script block
HeadScriptManager.Current.RegisterHeadScriptBlock(typeof(Page), "SayHello", "<script type=\"text/javascript\">alert('Hello!');</script>");

UPDATED WIKI: DNAideXmlSiteMapProvider

stebrennan — Sat, 10 Mar 2007 11:53:44 GMT

DNAideXmlSiteMapProvider

A number of key extensions to the default XmlSiteMapProvider:

Simple "hook in" to the DNAide UrlRewriter
You can now set the value of the "key" attrbute (not available with the XmlSiteMapProvider)
Virtual method "BuildSiteMapFile" - a simple way to generate dynamic sitemaps (see "More Advanced Example" below).

Simple Configuration

<system.web>
	<siteMap enabled="true" defaultProvider="DNAideXmlSiteMapProvider">
		<providers>
			<clear/>
			<add name="DNAideXmlSiteMapProvider" type="DNAide.Web.DNAideXmlSiteMapProvider" siteMapFile="Web.sitemap" />
		</providers>
	</siteMap>
</system.web>

Simple SiteMap Example

<?xml version="1.0" encoding="utf-8" ?>
<siteMap xmlns="http://schemas.microsoft.com/AspNet/SiteMap-File-1.0" >
	<siteMapNode key="home" url="~/index.htm" title="Home" rewriteToUrl="~/_Templates/WebForms/Home.aspx">	
		<siteMapNode key="news-list" url="~/news/index.htm" title="Latest News" rewriteToUrl="~/_Templates/WebForms/NewsList.aspx">
			<siteMapNode key="news-1" url="~/news/dnaide-released.htm" rewriteToUrl="~/_Templates/WebForms/NewsView.aspx" />
			<siteMapNode key="news-2" url="~/news/another-story.htm" rewriteToUrl="~/_Templates/WebForms/NewsView.aspx" />
			<siteMapNode key="news-3" url="~/news/more-news.htm" rewriteToUrl="~/_Templates/WebForms/NewsView.aspx" />
			<siteMapNode key="news-4" url="~/news/oldest-news.htm" rewriteToUrl="~/_Templates/WebForms/NewsView.aspx" />
		</siteMapNode>
	</siteMapNode>
</siteMap>

Some interesting points about the above example:

Shows that you can set the "key" attribute
Additional (optional) attribute "rewriteToUrl". Best example being the individual news stories. Each story rewrites to the same ASPX template which will render the correct story. In the above example, I have stored the id of each story as part of the "key". The "NewsView.aspx" template can retrieve the current key value to determine which story to load from the database
Used ".htm" rather than ".aspx" for urls. This is entirely optional but to enable this, ensure that IIS is configured so that the .htm extension is mapped to ASP.NET

Rewrite attributes (requires using the DNAide UrlRewriter)

The following are optional:

rewriteToUrl: See above
redirectToSiteMapNodeKey: Redirect to another node in the sitemap
redirectStatusCode: i.e. what is added to the response header e.g. 301, 404 etc. Default = "301"

More Advanced Example

In the simple example above, the template that rendered news stories "NewViews.aspx" retrieves stories from a database. However, the siteMapNodes are not from a database but "hand written" into the "Web.sitemap".

The DNAideXmlSiteMapProvider class exposes a virtual "BuildSiteMapFile" method which is fired by the provider if the associated website file cannot be found. So a solution to the news stories:

Create a NewsXmlSiteMapProvider class inheriting from DNAideXmlSiteMapProvider and override the "BuildSiteMapFile" to read stories from the database and generate a relevant sitemap file.

public class NewsXmlSiteMapProvider : DNAideXmlSiteMapProvider
{
	public override void BuildSiteMapFile()
	{
		XmlWriterSettings settings = new XmlWriterSettings();
		settings.Indent = true;
		settings.IndentChars = "\t";
		settings.ConformanceLevel = ConformanceLevel.Document;
 
		using (XmlWriter writer = XmlWriter.Create(SiteMapPath, settings))
		{
			writer.WriteStartElement("siteMap", "http://schemas.microsoft.com/AspNet/SiteMap-File-1.0");
			writer.WriteStartElement("siteMapNode");
			writer.WriteAttributeString("key", "news-list");
			writer.WriteAttributeString("url", "~/news/index.htm");
			writer.WriteAttributeString("title", "Latest News");
			writer.WriteAttributeString("rewriteToUrl", "~/_Templates/WebForms/NewsList.aspx");
			
			// Retrieve news stories from the database (or whereever) and write out SiteMapNodes
 
			writer.WriteEndElement(); // Close news-list
			writer.WriteEndElement(); // Close siteMap
			writer.Flush();
		}
	}
}

Add the "NewsXmlSiteMapProvider" into your web.config

<siteMap enabled="true" defaultProvider="Main">
	<providers>
		<clear/>
		<add name="Main" type="DNAide.Web.DNAideXmlSiteMapProvider" siteMapFile="Web.sitemap"/>
		<add name="News" type="NewsXmlSiteMapProvider" siteMapFile="News.sitemap"/>
	</providers>
</siteMap>

Create a SiteMapNode in "Web.sitemap" using the "NewsXmlSiteMapProvider".

<?xml version="1.0" encoding="utf-8" ?>
<siteMap xmlns="http://schemas.microsoft.com/AspNet/SiteMap-File-1.0" >
	<siteMapNode key="home" url="~/index.htm" title="Home" rewriteToUrl="~/_Templates/WebForms/Home.aspx">	
		<siteMapNode provider="News" />
	</siteMapNode>
</siteMap>

Using the above example is a simple way to generate dynamic sitemaps. You have full control of the source for you sitemap i.e. you are not tied to SQLServer etc.

In the above examples, to get the sitemap to rebuild the sitemap file, simply remove it from your website e.g. if an administrator adds / updates / or removes a news story, delete the News.sitemap file and the file will then be recreated.

UPDATED WIKI: UrlRewriter

stebrennan — Sat, 10 Mar 2007 11:52:43 GMT

UrlRewriter

Configuration

The following must be added into your web.config:

<configSections>
	<sectionGroup name="dnAide">
		<section name="web" type="DNAide.Configuration.WebConfig" allowDefinition="MachineToApplication" restartOnExternalChanges="true"/>
	</sectionGroup>
</configSections>

Then add the dnAide configuration section:

<!-- dnAide -->
<dnAide>
	<web>
		<urlRewriter>
			<rules>
			</rules>
		</urlRewriter>
	</web>
</dnAide>
<!-- /dnAide -->

Then add the httpModule

<system.web>
	<httpModules>
		<add type="DNAide.Web.UrlRewriter" name="UrlRewriter"/>
	</httpModules>
</system.web>

Common urlRewriter configuration options

firesOnEvent: "BeginRequest, AuthorizeRequest, AuthenticateRequest, None". Default "BeginRequest"
virtualUrlsOnly: Rewriting will only occur for virtual file requests, i.e. the file does not physically exist on the server. Default "True"
applicableFileExtensions: Valid file extensions for rewriting to occur. Default ".asp,.htm". To allow all, use ".*"
defaultPage: If the requested Url does not include a file name i.e. http://www.mywebsite.com/news, this page will be appended by the rewriter to the url e.g. http://www.mywebsite.com/news/index.aspx

Experimental:

moveViewState: The rewriter can be used to move the ViewState to the bottom of the form. Useful for SEO.

Rules

Please note. You do not have to define your rules in the web.config. If you use a SiteMap, there are a couple of extra attibutes you can use which are linked to the UrlRewriter. See DNAideXmlSiteMapProvider for more info.

Configuring Rules

<rules>
	<!-- Simple rule -->
	<add id="rule-1" matchExpression="~/news/(.*)/(.*).aspx" destination="~/_Templates/WebForms/ViewNews.aspx" />
 
	<add id="rule-2" matchExpression="~/products/(.*)/(.*).aspx" destination="~/_Templates/WebForms/ViewProduct.aspx?id=$2" />
 
	<!-- Ignore rule -->
	<add id="ignore-rule-1" matchExpression="~/_Templates/(.*)" destinationType="Ignore"/>
</rules>

Common urlRewriter rule options

matchExpression: Regular expression used against requested Url
destination: Where the request should be redirected to
destinationType: "UrlPattern, SiteMapNodeKey, Ignore". Default "UrlPattern". "SiteMapNodeKey" will rewrite the request if a pattern is matched to a node in the sitemap
ruleType: "Rewrite, Redirect". Default "Rewrite".
redirectStatusCode: i.e. what is added to the response header e.g. 301, 404 etc. Default = "301"