E:\web\learnaspcom\htdocs\freebook\learn\ubtoc.xml LearnAsp.com - ASP ASP.net Free Lessons
Search Search

#1 worldwide
FREE Coding Lessons

since 1996
   THE BEST WAY to learn ASP & Asp.net!
Advertise Here!
click for details
Credits Host:
DiscountASP.net
Server Admin:
The "Team"
Contact Info.
Charles M. Carroll
<Asp.net blog>
<personal site>
xxx

Utility Belt Documentation: Options
by Charles Carroll

The Utility Belt options are rich and varied although many are seldomly used

Options(strOptions) - sends a command or several commands to Utility Belt to alter its behavior. It will issue warnings to developers and LOG entries if it is passed unknown options but Utility Belt will not halt or throw an error if it encounters an unknown option

 Advice-On,Advice-Off: Toggles the Advice that UB provides to assist the programmer in producing higher quality code. The Advice is always optional but do take it seriously and try to improve your code.

Cache-On,Cache-Off: Indicates whether all following UtilityBelt data fetches are fulfilled with caches.
http://www.learnasp.com/freebook/learn/utilitybelt_cached.aspx
http://www.learnasp.com/freebook/learn/utilitybelt_cached_sqlclient.aspx

Db-Force-OLEDB-On,DbForceOLEDB-Off - Forces UB to use the system.data.oledb no matter what connection string is supplied. Normally UB examines any connection string and then  determines most efficient way to connect - for example it uses SQLClient for SQLserver as opposed to OLEDB - given the appropriate connection string.

Db-Force-SQLClient-On,Db-Force-SQLClient-Off - Forces UB to use the system.data.sqlclient no matter what connection string is supplied. Normally UB examines any connection string and then  determines most efficient way to connect - for example it uses SQLClient for SQLserver as opposed to OLEDB - given the appropriate connection string.

Debug-On,Debug-Off - The easiest way to set 3 relevant options in 1 step: Advice-on, Errors-On,Messages-On,Warnings-On.

Error-IgnoreNext-On, Error-IgnoreNext-Off - normally these are rarely used. They basically allow you to turn Off/On the pretty error trapping and let errors occur without being intercepted by UtilityBelt.

Errors-On,Errors-Off - Toggles display of any Errors that UB caught internally and errors from LogException(...) if programmer using library called that.

Hints-On,Hints-Off - Toggles display of any Hints about possible error message causes that UB caught internally and errors from LogException(...) if programmer using library called that.

Http-HTMLEncode-Out-On, HTTP-HTMLEncode-Out-Off - Toggles whether output of future HTTP Calls are HTMLencoded, for example whether <b>hello</b> there appears as
<b>hello</b> there
or
hello there

HttpURLEncodeInputOn, HttpURLEncodeInputOff - Toggles whether any parameters passed to any HTTP calls are encoded by server.urlencode for example "Charles Mark Carroll" being encoded as "Charles+Mark+Carroll".

Log-XML-On, Log-XML-Off - Turns on/off errorlogging to a predefined XML format.

Log-Db-On, Log-Db-Off - Turns on/off data logging.

Log-EventLog-On, Log-EventLog-Off - Turns on/off error logging to Win Event Log.

Log-DiskEmpty-Warn-On, Log-DiskEmpty-WarnOff - Turns on/off error logging to Win Event Log.

Messages-On, Messages-Off - Toggles messages display. Typical messages include HTTP URLs, SQLstrings, Cache Hits and Misses, etc. .

NullBind-On,NullBind-Off - Toggles whether binding errors caused by nulls in DbPopulate results in an error or continue without incident.

Trace-On,Trace-Off - Toggles whether trace at the page level occurs. Trace-Off overrides any trace="true" statement at page level.

WS-AsRawXML-On, WS-AsRawXML-Off - Normally XML Webservice data is returned in datasets for convenience. The off option ensures raw unaltered XML is returned instead of DataTables.

Xray-On, XRay-Off - Toggles subsequent Xrays on or off without having to comment out the code that invokes Xrays line-by-line.

Xray-To-Page-On, XRay-To-Page-Off - Toggles Xrays being displayed on page in attractive grid format.

There are many worthy charities!!. But perhaps help starving children in Africa or South America AND help Charles too. a $5 tip buys him lunch at McDonalds, a $20 tip buys his kid Hitoshi a new computer game, a $39 tip buys his daughter Michiko a few nice outfits. See our donor list.