UltraWebNavigator(TM)
.NET
Tree and Menu Control and Design Environment
for ASP.NET
Version 3.00.20033.8.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 UltraWebNavigator. Be sure to read through the help file topics for important information on how to best use UltraWebNavigator.
.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 v3.00.20033:
WebMenus:
- Menu Scrolling (XP look and standard look). When the number of items in a submenu exceeds
the amount of space available in the browser window, the submenus have arrows
added to the top and bottom that automatically permit the user to move the
mouse cursor over and scroll down or up to display all menu items.
- Support for menu item borders. Menu items can now have borders along with
borders for the hover style.
- Support for submenu display on the left or the right of parent menus
- Server-side property can be set to control submenu orientation. If menus
run out of room they are automatically switched to the opposite display mode.
- BorderDetails sub object of the Style object. Left, Top, Right and Bottom
values can be set for BorderWidth and BorderColor attributes.
- Additional style presets
- Enhanced Standard Web Menu style using borders
- Windows XP silver, blue and green color schemes
- Office 2003 look and feel with silver, blue and green color schemes
- Ability to display menus above other windowed controls on the page. No
special properties need to be set, no extra coding required for IE 55 and above
- Improved Client Side
Object Model (CSOM)
- Version 3 changes the structure from a 3 column table to a
1 column table.
V2 Image Column, Text Column, Submenu Image
V3 All three values are placed within one column and the CSS Float attribute
is used to position the images to the left and right of the text.
WebTree:
- Additional support for binding Image and TargetFrame node
properties
- Support for multiple key fields on databinding
- Additional Style property for setting the attributes of the input edit
field on the client
- Support for client-state updating to server
- Support for AutoPostback flags
- Client-side Node.getLevel() and Node.getIndex() methods
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.
Before upgrading your project to version 3 you should make a backup copy of all files in the project.
To upgrade an existing project to version 3, follow these steps:
1. After opening the version 2 project, click on Project References and remove the entry for Infragistics.WebUI.UltraWebNavigator.v2.dll. Right-click to add a reference and select Infragistics.WebUI.UltraWebNavigator.v3.dll from the list of available .NET components.
2. If you attempt to open an aspx form containing UltraWebTree or UltraWebMenu, 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.UltraWebNavigator.v2.dll to Infragistics.WebUI.UltraWebNavigator.v3.dll. 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 WebNavigator v3 will be loaded in place of the v2 version.
3. Open the file called licenses.licx in your project directory with notepad and change the reference from Infragistics.WebUI.UltraWebNavigator.v2.dll to Infragistics.WebUI.UltraWebNavigator.v3.dll. Save the licenses.licx file.
4. The names of the default virtual directories for images and script have been changed from /ig_Scripts2 and /ig_Images2 to ig_common\webnavigator3. Be sure that the JavaScriptFileName property of the control has been updated to reflect that.
5. Delete the file Infragistics.WebUI.UltraWebNavigator.v2.dll from the bin directory of the project so that only the Infragistics.WebUI.UltraWebNavigator.v3.dll file remains. This will eliminate runtime errors due to multiple references to objects.
Script
and Image Files:
This version of WebNavigator
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\WebNavigator3. If this registry
entry is not found then the files are installed to c:\program files\common
files\infragistics\web\WebNavigator3. The virtual directories that map to
these physical directories are named ig_common\webnavigator3.
UltraWebNavigator 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 assembly must be copied to the local project directory
along with the UltraWebNavigator assembly in order to run the Web application
under IIS.
Browser Support
The UltraWebTree and
UltraWebMenu controls each have two modes of browser support: Up-level and
Down-level. When the BrowserTarget property is set to Auto, these
components consider Internet Explorer 5 and above to be up-level browsers and
all other browsers including Netscape 4.x and Netscape 6.x are considered
down-level for the purposes of DHTML execution compatibility.
UltraNavStudio only supports rendering to HTML files of up-level HTML code. If down-level rendering is required, then the igproj file can be loaded into the UltraWebMenu or UltraWebTree control at run-time and rendered appropriately for the user agent in use.
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, UltraWebNavigator 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 UltraWebNavigator and
then v3.00.
2) run WebNavigatorRemovevd.bat This file takes 2 parameters, the first is the drive where UltraWebNavigator is installed. The second is the full path to where UltraWebNavigator is installed. Here is an example of what it would look like for a default install:
webnavigatoremovevd c: "c:\program files\infragistics\ultrawebnavigator\v3.00\
This will remove the virtual directories that may be present from a previous install of UltraWebNavigator.
3) run webnavigatorsamplesetup.bat This file takes 3 parameters, the first is the drive where UltraWebNavigator 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:
webnavigatorsamplesetup c: "c:\program files\infragistics\ultrawebnavigator\ v3.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_ultrawebnavigator2samples (the default path is c:\program files\infragistics\ultrawebnavigator\ v3.00\samples)
7) Under Default Website there should now be an entry for ig_ultrawebnavigator2samples. Expand this.
8) Expand UltraWebTree, then Cs. For each directory under here right click, and select properties. Click on the Create button under Application settings. Do the same for each directory under the VB folder.
9) Repeat step 8 for the UltraWebMenu folder.
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/WebNavigator3
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\WebNavigator3.
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=88&articlestypebugfix=on
UltraWebNavigator
3.00.20033.08.01 October, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Initial Release
UltraWebNavigator
2.00.5000.112.01 June, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
UltraWebNavigator.v2.dll (2.00.5000.112)
UltraWebNavigator
2.00.5000.107.01 March, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
UltraWebNavigator.v2.dll (2.00.5000.107)
UltraWebNavigator
2.00.5000.104.01 January, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
UltraWebNavigator
2.00.5000.102.00 December, 2002
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Initial Release