HOW TO: Configure Microsoft .NET Speech SDK Beta 2 for Improved Compatibility with Microsoft .NET Framework 1.1

This article discusses a known compatibility issue with Microsoft .NET Speech SDK Beta 2 (Speech SDK) installed on computers with Microsoft .NET Framework 1.1.

This issue was previously published in the Speech SDK Release notes and has been updated to include a workaround as detailed in the "More Information" section. You can view the SDK Release notes at the following Microsoft Web site:

Scenario

Microsoft .NET Speech SDK Beta 2 may not function correctly on systems with current or previous installations of the .NET Framework 1.1. This issue applies to the development of new speech-enabled Web applications and the use of the existing speech-enabled sample Web applications that are included with the Speech SDK.

Microsoft .NET Framework 1.1 is not compatible with the Beta 2 release of Microsoft .NET Speech SDK.

To decrease the incompatibility issues that you experience during your evaluation of the Speech SDK, use the following workaround methods.

Set Up Initial Installation Environment

To make sure that the Speech SDK is in an appropriate installation environment, you must remove all currently installed versions of the Microsoft .NET Framework and the Microsoft .NET Speech SDK.

If you have any of the following products installed, remove them in the following order:

1. Microsoft .NET Framework 1.1
2. Microsoft .NET Speech SDK Beta 2
3. Microsoft .NET Framework 1.0

Restart your computer, and then reinstall the following products in the following order:

1. Microsoft .NET Framework 1.0
2. Microsoft .NET Framework 1.0 SP2
3. Microsoft .NET Speech SDK Beta 2
4. Microsoft .NET Framework 1.1

NOTE

• The preceding steps apply to Microsoft Windows 2000 and to Windows XP Professional.
• Windows Server 2003 is not supported in the Beta 2 release of the Speech SDK.
• If installed, do not remove Visual Studio .NET 7.0. You have to have this product to use the Visual Studio .NET Speech Development Tools that are installed with the Speech SDK.

You can download all the products listed earlier from the following Microsoft Web site:

Update the Page Directive for the Sample and Demo Applications

1. Open each Web.config file in the subdirectories of the Speech SDK Applications directory. By default, this directory is located in the following folder:
   \Program Files\Microsoft .NET Speech\Applications
2. Add <pages validateRequest="false" /> to each Web.config file. For example:

   <?xml version="1.0" encoding="utf-8" ?> 
   <configuration> 
           <system.web> 
                   <pages validateRequest="false" /> 
           </system.web> 
   </configuration> 
   

Optional: Add Custom Speech SDK IIS Mappings

The following instructions apply only if you continue to experience problems while using the Margie’s Travel or Contacts sample applications in the Speech SDK.

Open Internet Information Services (IIS):

1. Right-click My Computer, and then click Manage.
2. Expand the Services and Applications node, and then select Internet Information Services.
3. Locate and expand the Default Web Site node, and then view the Demo node and the Contacts node for the Speech SDK.

Add Custom IIS Mappings for the Margie’s Travel Sample Application

1. Right-click the Demo virtual directory, and then click Properties.
2. On the Virtual Directory tab, click Configuration, and then click Add.
3. In the Executable field, type the path of the .NET Framework 1.1 version of the Aspnet_isapi.dll file. By default, this file is located in: %WINDIR%\Microsoft.NET\Framework\v1.1.4322\aspnet_isapi.dll
4. In the Extension field, type .gramx.
5. Select Limit to, and then type GET,HEAD,DEBUG.
6. Select the Script Engine check box, and clear the Check that file exists check box.
7. Click OK to apply the changes.

Add Custom IIS mappings for the Contacts Sample Application

1. Right-click the Contacts node, and then click Properties.
2. On the Virtual Directory tab, click Configuration, and then click Add.
3. In the Executable field, type the path of the .NET Framework 1.1 version of the Aspnet_isapi.dll file. By default, this file is located in the following folder:
   %WINDIR%\Microsoft.NET\Framework\v1.1.4322\
4. In the Extension field, type .grxml.
5. Select Limit to, and then type GET,HEAD,DEBUG.
6. Select the Script Engine check box, and then clear the Check that file exists check box.
7. Click OK to apply changes.

Optional: Repair Default IIS Mappings

If the preceding instructions do not address the Microsoft .NET Framework 1.1 compatibility issues that you are experiencing, use the following instructions to repair your IIS Mappings. After you perform this task, you must add custom Speech SDK IIS mappings again, as described earlier in this article.

To repair IIS mappings for ASP.NET, run the Aspnet_regiis.exe utility:

1. Click Start, and then click Run.
2. Type the following command, and then click OK:
   "%WINDIR%\Microsoft.NET\Framework\v1.1.4322\aspnet_regiis.exe" -i