Infragistics(R) NetAdvantage(R) ASP.NET
NetAdvantage ASP.NET 2012.2
E-mail your feedback on this topic.

Glossary Item Box

Before you start using NetAdvantage ASP.NET, be sure to read through the topics in this section to ensure that you are getting the most of out of the product.

Using the Help


These sections are designed to aid a user when they are navigating the help. The sections below contain any changes or new additions to the help.

Installing NetAdvantage ASP.NET

These topics contain important tips and notes on installing NetAdvantage ASP.NET:

Installing NetAdvantage for .NET on Windows Vista

Starting with the NetAdvantage ASP.NET 2006 Volume 3 (CLR 2.0) release, you can install NetAdvantage ASP.NET on the Microsoft® Windows® Vista operating system. Read further for important information about successfully installing NetAdvantage ASP.NET on Vista.

  • Vista is supported only on Visual Studio 2005 and later versions of Visual Studio; is not supported on Visual Studio 2003 and earlier. Therefore, all CLR 1.x versions of NetAdvantage ASP.NET are not supported on Vista. However, the stand-alone version of the NetAdvantage AppStylist® product can be installed on Vista.

Tips for Installing NetAdvantage for .NET

Sometimes, software installations don't go exactly as planned. We realize that everyone has a different machine setup and we've put together a list of troubleshooting tips that can help ensure that NetAdvantage ASP.NET installs as smoothly as possible.

  • You must be logged in as an Administrator to install NetAdvantage ASP.NET. This login must also be able to update the system registry.
  • Make sure there is enough space for installation, including your temporary files. By default, Windows stores temporary files in the directory C:\WINDOWS\Temp.
  • Microsoft® Visual Studio® must be installed and kept closed while installing NetAdvantage ASP.NET and/or any of the NetAdvantage utilities (e.g. Toolbox utility)..
  • The install should be run from a local hard drive. You might encounter issues if it is run from a network drive.
  • If you have already installed the trial version of NetAdvantage ASP.NET, there is no need to uninstall/reinstall the software. You can simply run the installer file (e.g., NetAdvantage_NET_20082_CLR2x.exe) from the appropriate directory (e.g., C:\Program Files\Infragistics\NetAdvantage 2012.2\ASP.NET) and insert your CD-Key when prompted by the installation wizard.
  • If you receive an error stating that your license key is invalid during the installation, first confirm that you entered the key correctly. If you did, cancel the installation (do not "install as trial"), reboot your computer, and run the installer file again, as this clears the incorrect value from the internal cache.
  • The file name (including all path information) cannot exceed more than 256 characters -- this is a limitation of Windows®. Our installer works around this internally by using the "8.3" notation, where for example "C:\Program Files\" is referred to as "C:\PROGRA~1\". If you provide a destination folder name that is too long when installing NetAdvantage ASP.NET, you may receive a "file is missing or corrupt" error.
  • This installation will stop and restart IIS in order to install the ASP.NET assemblies, scripts, and virtual folders. This is a DEVELOPER installation package. Please do not use this install to deploy. Review the product help for deployment topics.
  • If you install any combination of the NetAdvantage ASP.NET installs and remove one of them at a later time, this might result in known issues. To resolve these issues, reinstall the appropriate NetAdvantage ASP.NET product.
  • If IIS is installed on Windows® Vista™, you need to follow specific steps prior to running the NetAdvantage ASP.NET installer. These steps are documented in the Infragistics Knowledge Base article Installing NetAdvantage for .NET on Windows Vista. After following these steps, you should be able to successfully install NetAdvantage ASP.NET.
  • If you have NetAdvantage AppStylist for ASP.NET installed, and you modify one of the installed Infragistics Style Library (*.isl) files or Web Style Library (*.wsl) files, respectively, and want to save the changes for later, ensure that you save your changes as a different file. This will ensure that your customized .isl or .wsl files are not overwritten by a NetAdvantage ASP.NET hotfix, or removed during a NetAdvantage ASP.NET uninstall.

Where Files are Placed on your File System During Installation

This topic explains where files and folders that are included in the Installer are placed on your file system.

Excel Engine and Document Engine Assemblies

C:\Program Files\Infragistics\NetAdvantage 2012.2\ASP.NET\CLR2xCLR35\Bin

This folder contains the assemblies for the Excel Engine and Document Engine.

Web Presets

XP -- C:\Documents and Settings\All Users\Documents\Infragistics\NetAdvantage 2012.2\Presets\CLR2xCLR35\Web

Vista \ Windows 7 -- C:\Users\Public\Documents\Infragistics\NetAdvantage 2012.2\Presets\CLR2xCLR35\Web

This folder contains all the in-box presets provided by Infragistics for all NetAdvantage ASP.NET controls and components. You can use a preset to apply a range of formatting and behavior options across the elements of your interface and applications.

There are three different types of presets:

  • Look -- Contains information for the visual styling of the control or component
  • Behavior -- Contains information on how the control or component will behave
  • Look and Behavior -- Contains information on the visual styling of the control or component and the behavior of the control or component
Web Styles

During installation you will be given the option to install 'Just Me' or 'All Users'. Depending on your selection, the Templates, Palettes and Styles folders will be placed in different areas.

In XP - 'Just Me' option selected

C:\Documents and Settings\[USERID]\MyDocuments\Infragistics\NetAdvantage 2012.2\ASP.NET\StyleLibraries

In XP - 'All Users' option selected

C:\Documents and Settings\AllUsers\Documents\Infragistics\NetAdvantage 2012.2\ASP.NET\StyleLibraries

In Vista

C:\Users\Public\Documents\Infragistics\NetAdvantage 2012.2\ASP.NET\StyleLibraries

This folder contains all the styles available within ASP.NET. Styles are used by the Application Styling Framework (ASF) when styling your application.

Global Assembly Cache

C:\WINDOWS\assembly\

By default when you install NetAdvantage ASP.NET, the control assemblies are installed into the GAC.  

For more information on installing NetAdvantage ASP.NET, see Deploying Your Application section in the ASP.NET help. 

Main Infragistics Installation Folder

This folder and its sub-folders contain the ASP.NET Assemblies that are used at design-time as well as the assemblies that are used at runtime. Other files include utility applications such as the Project Upgrade Utility as well as files that are depended on by certain controls (e.g. the Dictionary files used by WebSpellChecker).

 

Running the Toolbox Utility

The easiest way to add all of the tools available in the NetAdvantage for .NET toolkit to your Visual Studio .NET toolbox is to run the Create Visual Studio Toolbox Tab utility.

To run the Toolbox Utility:
  1. Close all running instances of Visual Studio .NET.
  2. From the Windows Start menu, navigate to the utility as follows:

    CLR 2.0 :

    Start > All Programs > Infragistics > NetAdvantage 2012.2 > ASP.NET > Utilities > Create Toolbox Tab for CLR 2.0


    CLR 3.5 :

    Start > All Programs > Infragistics > NetAdvantage 2012.2 > ASP.NET > Utilities > Create Toolbox Tab for CLR 3.5

  3. The utility installs the NetAdvantage for .NET controls and components in the Visual Studio toolbox. Keep in mind that the installation of the controls and components is dependent on the NetAdvantage for .NET product that is installed. For example, if you install only the NetAdvantage Windows Forms product, the utility installs only the NetAdvantage Windows Forms controls and components. If you install both NetAdvantage for Windows Forms and NetAdvantage ASP.NET products, the utility installs the controls and components for both products.
  4. If the utility installed the controls and components for both Windows Forms and ASP.NET products, in Visual Studio, you can choose to show the tabs for both products by right-clicking anywhere in the toolbox, and selecting "Show All Tabs".
Note: If Microsoft SQL Server 2005 or SQL Server Management Studio Express (CTP) is installed, and you run the Create Visual Studio Toolbox Tab utility, you will encounter an error because SQL Server overwrites registry settings. For more information on this known issue and the (cautionary) workaround, see the Knowledge Base article, Toolbox Utility Fails to Load (CLR 2.0), on Infragistics' DevCenter.
Related Topics

Using the Choose Toolbox Items Dialog Box

As an alternative to Running the Toolbox Utility to add NetAdvantage for .NET controls/components to the Visual Studio .NET toolbox, you can add the tools manually using the Choose Toolbox Items dialog box.

To manually add NetAdvantage ASP.NET controls and components:
  1. To create a new toolbox tab, right-click anywhere on the toolbox and select Add Tab.
  2. In the empty field at the bottom of the toolbox, type "NetAdvantage 12.2 Web" and press ENTER.
  3. Click the newly added tab.
  4. Right-click anywhere on the toolbox and select "Choose Items..." to open the Choose Toolbox Items dialog box.
    Customize Toolbox Dialog
  5. Scroll through the list, and select the check boxes corresponding to the NetAdvantage ASP.NET controls and components that you want to add to the toolbox.
    Note: If you want to add the WebResizingExtender control to the toolbox, make sure that you have already installed Microsoft® ASP.NET 2.0 AJAX Extensions; otherwise, you will receive an error message. To install the ASP.NET 2.0 AJAX Extensions, you can run the following installer, which is located in the default installation directory for the NetAdvantage for .NET product: C:\Program Files\Infragistics\NetAdvantage 2012.2\ASP.NET\ASPAJAXExtSetup.msi.
  6. Click OK.

Dragging Assemblies from the Bin Folder

As an alternative to Running the Toolbox Utility to add NetAdvantage ASP.NET controls/components to the Visual Studio .NET toolbox, you can drag Infragistics' assemblies from your Bin folder to the Microsoft® Visual Studio® toolbox.

To drag Infragistics' assemblies from your Bin folder to the Visual Studio toolbox:

  1. In the Visual Studio IDE, make sure that the toolbox is visible by selecting Toolbox on the View menu.
  2. Right-click anywhere on the toolbox and select Add Tab.
    Visual Studio toolbox context menu showing and the Add Tab option highlighted..
  3. Give the tab a meaningful name such as "NetAdvantage ASP.NET", you may also want to add the volume number (e.g., 8.1, 7.3, 7.2, 7.1) as a suffix.
  4. Repeat steps 2 and 3 for all the tabs you want to create.
  5. In Windows Explorer, navigate to the Bin directory where the NetAdvantage ASP.NET assemblies are installed. The assemblies contain the DLLs that you want to add:
    • ASP.NET -- C:\Program Files\Infragistics\NetAdvantage 2012.2\ASP.NET\CLR3.5\Bin
  6. Select the DLLs that contain the NetAdvantage ASP.NET controls/components you want to add to the Visual Studio toolbox.

    Location of assemblies highlighted to be dragged over to the toolbox.

  7. Drag the DLLs over to the Visual Studio tab you created in steps 2 to 4.

Note: If you add all the tools to the toolbox at the same time, it may take a few seconds for Visual Studio to add them all.


Running ASP.NET Product Samples

When using the shortcut off the Programs menu to launch the NetAdvantage ASP.NET product samples, you may receive a "Page not found" error. The reason for this error is that the page is trying to load before the local IIS server has finished loading.

To resolve this issue, perform either of the following steps:

If you attempt to use the shortcut off the Programs menu to launch the samples while the IIS server is already running, you may encounter issues, as the link will attempt to start a server on the same port as the one already running. To resolve this issue, stop the current server that is running.

Getting Support

If you own a copy of NetAdvantage ASP.NET, you are entitled to certain benefits regarding support services offered by Infragistics.

Creating a Member Profile

Visit the "My Infragistics" area of Infragistics' Web site, and create a Member Profile. It is important that your most current information is entered into your Member Profile, this will ensure that our Support Service Department can deliver support correspondence and subscription upgrades to you.

Registering your Product Key

After creating a Member Profile, register your Product Key to your MemberID by visiting the Product Registration page. This will provide you with superior technical support services quickly and conveniently. Your MemberID is connected to your personal profile. Your registration identifies you as the active developer entitled to use and request support for the Infragistics product you have registered.

Getting MemberID Information

You can always visit your Registration Records and review your purchases, issued subscription upgrade keys and registered keys online, 24 hours a day, 7 days a week. After logging in with your MemberID, you'll be able to view vital information including product keys and subscription service and status.

Getting Help

A wealth of valuable information is available at our DevCenter. DevCenter is a customer community location for self-service support information, technical articles, reference applications and much more. For more information on what help is available, hover your mouse over the "Support" menu item in the left pane of DevCenter.

Important Support Policies and phone support contact information is also available on DevCenter.

Note: You must have valid priority support to access phone support.

Each Infragistics product registered user can submit requests for technical support via the Web site. To log an incident or start any support issue, please log on to DevCenter to Submit a Support Issue and enter your MemberID. For your convenience, you can also attach a sample project if applicable.

Product Life Cycle

Infragistics Product Life Cycle information is available in PDF format and provides the following information:

Click here to download the PDF file.

For issues related to your account, product ownership, or registration, please e-mail Registrations@Infragistics.com. Include your name and product key (if known) so that we may better assist you. You can also call (609) 448-2000 9 a.m. to 5 p.m., Monday to Friday, EST US.