UltraWebBars(TM)

.NET Listbar, Tab and Toolbar Controls
for ASP.NET

Version 2.00.20033.08.01 - October, 2003

(C) Copyright Infragistics, Inc., 2001-2003

Infragistics, Inc., Windsor Corporate Park, 50 Millstone Road, Building 200 - Suite 150, East Windsor, NJ 08520

Voice 609-448-2000, Fax 609-448-2017, Internet http://www.infragistics.com

This document contains release notes for UltraWebBars. Be sure to read through the help file topics for important information on how to best use UltraWebBars.

.NET Framework Compatibility:
All included assemblies have been built against the Microsoft .NET framework 1.0 RTM build. You must have either the 1.0 or 1.1 RTM build of the framework installed for the product to work.

New Features in v2.00.20033:
  ClientSideEventsEditor:
Adding a handler for a ClientSideEvent is now just as easy as adding a server-side event handler.  Clicking on the ClientSideEvent name at design time will drop down a list of JavaScript functions currently defined on your WebForm.  There will also be an option to Add a New Function.  When this option is chosen, a new JavaScript function stub will automatically be generated for you and added to your WebForm.  You will automatically be brought to the new function, and you can start writing your code to handle the event.

  Design-Time HTML Intellisense:
To enable Design-Time HTML Intellisense, Right-Click on the control.  You will notice there is an option to "Enable HTML Intellisense".  Clicking on this option will put an extra attribute in the WebForm's body tag.  This attribute will allow Intellisense to work at design time, for the HTML view of the webform.  When you are done working with the HTML, you can turn off this option and remove the attribute by again Right-Clicking on the control, and unchecking the "Enable HTML Intellisense" option.

Upgrading to Version 2:
Version 2 of UltraWebBars appends a .v2 to the end of the assembly names to help insure proper versioning in Visual Studio and to enable clean side-by-side execution with version 1 of the product.

Before upgrading your project to version 2 you should make a backup copy of all files in the project.

The steps here are indicated for the UltraWebListbar control.  Follow similar steps for the UltraWebTabs and UltraWebToolbar controls.

To upgrade an existing project to version 2, follow these steps:

1. After opening the version 1 project, click on Project References and remove the entry for Infragistics.WebUI. UltraWebListbar.dll.  Right-click to add a reference and select Infragistics.WebUI. UltraWebListbar.v2.dll from the list of available .NET components.

2. If you attempt to open an aspx form containing UltraWebListbar, you will see the controls displayed as an error.  To fix this, click the HTML tab at the bottom of the form and edit the aspx. file as text.  In the <%@ Register TagPrefix directive at the top, change the Assembly attribute from Infragistics.WebUI. UltraWebListbar to Infragistics.WebUI. UltraWebListbar.v2.  Upon completing this change you should immediately save the aspx file and close it.  Do not switch back to design mode and make any changes to the file.  Once the file has been saved and closed it can be reopened and the WebListbar v2 will be loaded in place of the v1 version.

3. Open the file called licenses.licx in your project directory with notepad and change the reference from Infragistics.WebUI. UltraWebListbar.dll to Infragistics.WebUI. UltraWebListbar.v2.dll.  Save the licenses.licx file.

4. The names of the default virtual directories for images and script have been changed from \ig_Scripts to and \ig_Images to ig_common\webbars2.  Be sure that the JavaScriptFileName property of the control has been updated to reflect that.

5. Delete the file Infragistics.WebUI. UltraWebListbar.dll from the bin directory of the project so that only the Infragistics.WebUI. UltraWebListbar.v2.dll file remains.  This will eliminate runtime errors due to multiple references to objects.

Script and Image Files:
This version of WebBars installs images and JavaScript files into a standard directory structure.  The location for scripts and images is determined by reading the registry entry:  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\INetStp\PathWWWRoot.  If that is set to the IIS default then these files are installed to C:\inetpub\wwwroot\aspnet_client\infragistics\WebBars2.  If this registry entry is not found then the files are installed to c:\program files\common files\infragistics\web\WebBars2.  The virtual directories that map to these physical directories are named ig_common\webbars2.

UltraWebBars has a Client-Side Object Model (CSOM).  To support this functionality, a common javascript file is shared by all of the Infragistics WebControls.  The location of this file is specified using the JavaScriptFileNameCommon property.  By default, it is in a virtual directory /ig_common/scripts/ig_csom.js which maps to the physical path c:\inetpub\wwwroot\aspnet_client\Infragistics\Scripts\ig_csom.js.

Running WebForms Applications
In order to run applications that use the Infragistics Web Controls on your machine, you will need to set the Copy Local flag to True for the Infragistics.WebUI.Shared.dll Assembly.  This is because Web Applications, by default, do not look in the GAC to resolve assembly references at runtime.  Therefore, the Infragistics.WebUI.Shared.dll assembly must be copied to the local project directory along with the UltraWebBars assembly in order to run the Web application under IIS.

Browser Support
The UltraWebBars controls have two modes of browser support: Uplevel and Downlevel.  When the BrowserTarget property is set to Auto, these components consider Internet Explorer 5 and above to be uplevel browsers and all other browsers including Netscape 4.x and Netscape 6.x are considered downlevel for the purposes of DHTML execution compatibility.

In general, the more cross browser support needed, the simpler the design of the control needs to be.  This is due to the variety of browsers available and their different capabilities and means of rendering.  Since the vast majority of browser use is with Internet Explorer, UltraWebBars is optimized for that environment.

Installation of Samples
On Windows XP machines, the data binding samples may display an exception stating that the user does not have access rights to the file or that the file is in use by someone else.

The cause of the problem is due to certain changes Microsoft made in the security settings and defaults for running Web applications on a Server. With the release version of Visual Studio.NET, Web applications running on the server are run under the ASPNET Windows account on the machine.  This account is only given User privileges when .NET is installed.  In order to open files for reading and writing, this account needs higher privileges. In order to change the privileges of this account, one must be logged onto the machine with Administrative privileges.  When logged on with Administrative privileges, one can go into Control Panel - Users and Passwords and change the member groups of the ASPNET account on the local server machine.  In order to run these samples, it is necessary for the ASP NET account to have Read / Write access to the sample databases. You can do this in Windows Explorer. Grant the ASP NET account Read / Write access to the install directory of the .NET Suite (e.g. C:\Program Files\Infragistics).  At this point, the sample application will be able to access the database file at runtime.

 

The installation for the Infragistics Web Controls attempts to automatically install all samples into the IIS virtual directory structures on the target machine so that the samples can be run easily and the sample projects can be opened in Visual Studio .NET.  However, under some circumstances, it may not be possible to complete this aspect successfully.  Therefore, the following information can be used to manually install the samples and get them running in the event that the automatic installation fails.

There are two different methods you can use that you can resolve this problem.

Method 1 - Running the Batch File:

1) open a command window.  Navigate to the installation folder.  By default this would be c:\program files\infragistics.  From here, go to UltraWebBars and then v2.00.

 

2) run WebBarsremovevd.bat  This file takes 2 parameters, the first is the drive where UltraWebBars is installed.  The second is the full path to where UltraWebBars is installed.  Here is an example of what it would look like for a default install:

WebBarsremovevd “c:” "c:\program files\infragistics\ultrawebbars\v2.00\”


This will remove the virtual directories that may be present from a previous install of UltraWebBars.

 

3) run WebBarsmakevd.bat  This file takes 3 parameters, the first is the drive where UltraWebBars is installed.  The second is the full path to the samples directory.  The third is the full path to the ig_common directory.  Here is an example of what it would look like for a default install:


WebBarsmakevd “c:” "c:\program files\infragistics\ultrawebbars\v2.00\samples" "C:\Inetpub\wwwroot\aspnet_client\Infragistics"

 

Note:  Quotes must be included.  The drive letters and directory names will be different if you did not use the default install path. 

 

Method 2 - Manually configuring IIS

1) Open IIS Admin (control panel->administrative tools->Internet Services Manager)


2) Expand Default Website


3) Right click Default Website and in the popup menu, select new->Virtual Directory


4) For Alias type ig_common, click next and browse to the ig_common directory.  By default it is C:\Inetpub\wwwroot\aspnet_client\Infragistics.


5) Click Next, then Finish.


6) Repeat steps 3-5 to create ig_ultrawebbars2samples (the default path is c:\program files\infragistics\ultrawebbars\v2.00\samples)


7) Under Default Website there should now be an entry for ig_ultrawebbars2samples.  Expand this. 


8) Expand UltraWebToolbar, then CS.  For each directory under here right click, and select properties.  Click on the Create button under Application settings.  Do the same for the 3 directories under the VB folder.


9) Repeat step 8 for UltraWebListbar and UltraWebTab folders. 


10) Under ig_ultrawebbars2samples right click the WebBarsDemo folder, click properties.  Click the Create button under Application settings. 

 

All samples should now be ready to run.

 

 

Installation of JavaScript Files
Correct installation of the JavaScript file requires that it be copied to the /ig_common/WebBars2 virtual directory within IIS in order to be accessed at runtime.  By default, the product installation maps this directory to C:\Inetpub\wwwroot\aspnet_client\Infragistics\WebBars2.  If you receive updates for JavaScript files, they should be placed into this directory to overwrite the older copies.

 

Version Numbers:
After careful input from our development team and Enterprise customers we have modified our version number system for the Vol. 3 release.

Because of issues with version in .NET the system uses a couple of parts.  To avoid issues with side-by-side versioning the GAC file names contain the major version as part of the file name. 

Examples

Infragistics.Win.UltraWinGrid.v3.dll
Infragistics.WebUI.UltraWebNavigator.v3.dll

The .v# in the file name is used to indicate a major new version.

The current system of version number will be changed to allow customers to easily tell a large volume of information from the version number.  The first digit will contain the major version number of the control.  This is different from the volume number of the entire toolset because not every control is modified in every release.

The second digits are for minor revisions to the control and will be used to denote minor modification to a control that does not reach the level of a major release but are greater than a hotfix, such as an addition of a handful of properties, methods, or events.

The third set of digits is for the year and volume number that control was last released in.

The final set of digits is the build number.  This is increased each time a build is dropped to our internal QA area.  All of these builds are not sent out to customers.

The final set of digits also easily notifies you that this is a full regression tested build or a hotfix.  If the build number starts with 100X it is not regression tested and is a hotfix build.  If the build does not start with 100X it is a fully tested release.

Examples

3.00.20033.5 = Beta 1
3.00.20033.10 = 5 drops later Beta 2
3.00.20033.11 = 1 drop later Gold 2003 Volume 3 release
3.00.20033.1012 = 1 drop later First hot fix
3.00.20033.1017 = 5 drops later hot fix
3.00.20041.18 = 1 drop later Gold 2004 Volume 1 release
3.00.20041.1019 = 1 drop later First hot fix
3.00.20041.1024 = 5 drops later hot fix
4.00.20042.1 = Beta 1 with major new features

 

Issues Addressed:

Use the knowledge base in the Infragistics Support Center
http://www.infragistics.com/support/supportcenter.asp
to review the history of addressed issues.
http://www.infragistics.com/process/p_knowledge.asp?product=35&articlestypebugfix=on

 

UltraWebBars 2.00.20033.08.01 – October, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Initial Release

 

UltraWebBars 2.00.5000.00.01 – June, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Initial Release

UltraWebBars 1.00.6007.24.01 – March, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
 

UltraWebBars 1.00.6007.22.01 – January, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes

UltraWebBars 1.00.6007.21.01 – December, 2002
-------------------------------------------------------------------------------------------------------------------------------------------------------------
- Full Release

UltraWebBars 1.00.6007.18.01 – August, 2002
-------------------------------------------------------------------------------------------------------------------------------------------------------------
- Full Release

UltraWebBars 1.00.6007.07.00 – March, 2002
-------------------------------------------------------------------------------------------------------------------------------------------------------------
- Full Release

UltraWebBars 1.00.6007.00.01 - February, 2001
------------------------------------------------------------------------------------------------------------------------------
- Full Release

UltraWebBars 1.00.6007.00.00 - February, 2001
-------------------------------------------------------------------------------------------------------------------------------------------------------------
- Initial Release