Measurement Studio 2010 Service Pack 1 (SP1) for Visual Studio 2010 Readme

Measurement Studio is an integrated suite of tools and class libraries that are designed for developers using Microsoft .NET technologies to develop measurement and automation Windows and Web applications.

Measurement Studio 2010 SP1 includes separate, parallel sets of class libraries, integration features, and support documentation for developing with Visual Studio 2010, Visual Studio 2008, and Visual Studio 2005. This readme documents only Measurement Studio support for Visual Studio 2010. Measurement Studio support for other versions of Visual Studio includes separate readme files; refer to these respective readme files for more information about Measurement Studio support for other versions of Visual Studio.

This file contains the following sections:

What's New in Measurement Studio 2010 SP1
Legacy Languages and Frameworks
Installing Measurement Studio 2010 SP1
Getting Started with Measurement Studio 2010 SP1
Bug Fixes in Measurement Studio 2010 SP1
Known Issues in Measurement Studio 2010 SP1
Notice Regarding Microsoft Silverlight Installation and Redistribution
Legal Information

What's New in Measurement Studio 2010 SP1

Measurement Studio 2010 SP1 is a maintenance release containing the following updates:

Verified compatibility with Visual Studio 2010 SP1—You can use Measurement Studio class libraries, integration features, and support documentation to develop with Visual Studio 2010 Service Pack 1 (SP1).
Bug fixes—Refer to the Bug Fixes in Measurement Studio 2010 SP1 section for more information.
Installer support for Measurement Studio C++ Legacy run-time dependencies—The Measurement Studio installer includes an additional feature, C++ Legacy Support Dependencies, and a sub-feature, C++ Legacy Support for NI Reports. Only install the C++ Legacy Support Dependencies feature if you are using Visual C++ MFC support for Visual Studio 2010 with the NI Measurement Studio for Legacy Environments/Languages product and you do not have Measurement Studio 2009 C++ MFC support installed. Only install the C++ Legacy Support for NI Reports feature if you plan to use Visual C++ MFC support for NI Reports in Visual Studio 2010 and later. These additional features do not install by default; complete the following steps to install them:
1. In the Measurement Studio installer, select Install with customization for Measurement Studio 2010 Service Pack 1 for Visual Studio 2010.
2. In the Features dialog, expand the Additional Features section.
3. Select Install this feature to a local drive to install the C++ Legacy Support Dependencies feature, or select Install this feature and its subfeatures to a local drive to install both features.
Refer to the Legacy Languages and Frameworks section for more information about the NI Measurement Studio for Legacy Environments/Languages product.

Legacy Languages and Frameworks

NI Measurement Studio 2009 was the last version of Measurement Studio to provide support for Visual Studio 6.0, Visual Studio 2003, and Visual C++ MFC. If you want to continue building or developing applications using these legacy environments/languages, you can use the NI Measurement Studio for Legacy Environments/Languages product, which includes the NI Measurement Studio 2009 DVD, the NI Measurement Studio 8.1.2 for Visual Studio 6.0 CD, and the November 2009 NI Device Driver DVD. NI Measurement Studio for Legacy Environments/Languages is available upon request for qualifying Measurement Studio customers.

Requesting NI Measurement Studio for Legacy Environments/Languages

To qualify to receive NI Measurement Studio for Legacy Environments/Languages, you must meet either of the following criteria:

You must maintain an active Measurement Studio Standard Service Program (SSP) contract; or
You must have purchased the most recent version of Measurement Studio.

Refer to ni.com/info and enter infocode MFCsupport if you require Visual C++ MFC support for Visual Studio 2010. For additional information or to request NI Measurement Studio for Legacy Environments/Languages, please contact a Technical Sales Representative at ni.com/contact.

Installing Measurement Studio 2010 SP1

The following sections list the system requirements for Measurement Studio 2010 SP1 and instructions on how to install Measurement Studio 2010 SP1.

Note Refer to the Measurement Studio 2010 SP1 Known Issues Web page for a complete, up-to-date list of known issues in Measurement Studio 2010 SP1 before you install the software.

Installation Requirements

To use Measurement Studio support for Visual Studio 2010 or Visual Studio 2010 SP1 , your computer must have the following:

Microsoft operating system:
- Windows 7 (32-bit or 64-bit), including Starter Edition (32-bit)
- Windows Vista (32-bit or 64-bit)
- Windows XP, Service Pack 3 (32-bit)
- Windows Server 2003 R2 (32-bit)
- Windows Server 2008 R2 (64-bit)
Microsoft .NET Framework 4.0
Visual Studio 2010:
- Ultimate Edition
- Premium Edition
- Professional Edition
- Visual C# Express Edition
- Visual Basic Express Edition
- Visual Web Developer Express Edition
Video display—1024 x 768, 256 colors (16-bit color recommended for user interface controls)
Minimum of 800 MB of free hard disk space
Microsoft-compatible mouse
Microsoft Internet Explorer 6.0 or later

Installation Notes

Measurement Studio does not support Windows Vista Starter Edition.
Measurement Studio 2010 SP1 does not support non-R2 editions of Windows Server.
This version of Measurement Studio supports, and was tested with, the latest Visual Studio service pack that was available at the time this version of Measurement Studio was released. National Instruments strongly recommends using Measurement Studio with the latest Visual Studio service pack.
This version of Measurement Studio supports, and was tested with, the latest operating system service pack that was available at the time this version of Measurement Studio was released. National Instruments strongly recommends using Measurement Studio with the latest operating system service pack.
If you want to upgrade your operating system from one major version to another, National Instruments recommends first uninstalling all National Instruments software, including application software and drivers. This is typically not necessary when installing an operating system service pack.
Microsoft Visual Studio Express Editions do not support Measurement Studio integrated tools.
In order for links from Measurement Studio help topics to .NET Framework help topics to work, you must install the product documentation for Visual Studio, which installs the MSDN Library. This requires a secondary installation during the Visual Studio installation process.
If you choose to view the Microsoft Visual Studio 2010 help online, the help viewer launches the Microsoft Developer Network (MSDN) Web site, which does not include the NI Measurement Studio Help. To view the Measurement Studio help, select Start»All Programs»National Instruments»Measurement Studio 2010 for Visual Studio 2010»Measurement Studio Documentation.
Some National Instruments components require Microsoft Silverlight 4.0. If you use a component that requires Silverlight, a dialog box prompts you to install Silverlight from the Internet. Microsoft Silverlight 4.0 is available from the Microsoft Web site at http://www.microsoft.com/silverlight. Measurement Studio does not contain Silverlight controls.

Installation Notes for Integrated Visual Studio 2010 Help

Use the following tips to ensure you can view Measurement Studio help integrated into Visual Studio 2010 and later.

Help Configuration Utility

By default, Visual Studio 2010 and later installs the Microsoft Help Library to the English locale. Measurement Studio provides a tool, HelpConfigurationUtility.exe, that you can use to install Measurement Studio for Visual Studio 2010 and later documentation to other Microsoft documentation locales. You can also use the Help Configuration Utility to uninstall or reinstall Measurement Studio documentation for Visual Studio 2010 and later. For more information on how to use this utility, refer to the Help Configuration Utility Readme located at [installdir]\National Instruments\Shared\MeasurementStudio\Help Configuration Utility, where [installdir] refers to the directory where you installed National Instruments software.

Note When using the Help Configuration Utility, National Instruments recommends that you always uninstall and reinstall all Measurement Studio help components. Installing Measurement Studio help components separately could cause unexpected results when viewing the help.

Working with Integrated Help

Review the following tips for working with the integrated help:

To view NI Measurement Studio 2010 SP1 help, you must install the Microsoft Developer Network (MSDN) documentation for Visual Studio 2010 and later before you install the Measurement Studio help. To work around this issue, you can install MSDN help and then either run the Measurement Studio installer in Repair Mode or use the Help Configuration Utility to reinstall the Measurement Studio help. The following instructions explain both workarounds:
Running the Measurement Studio Installer in Repair Mode
1. Select Start»Control Panel.
2. Select Add or Remove Programs.
3. Select National Instruments Software and click Change/Remove.
4. In the National Instruments Software dialog box, select NI Measurement Studio for VS2010.
5. Click Repair.
Using the Help Configuration Utility
1. Navigate to the following directory: [installdir]\National Instruments\Shared\MeasurementStudio\Help Configuration Utility.
2. Double-click HelpConfigurationUtility.exe to launch the utility.
3. Select the checkbox for the available Measurement Studio help components you want to install. National Instruments recommends you always install all Measurement Studio help components. Installing Measurement Studio help components separately could cause unexpected results when viewing the help.
4. Select the Microsoft Help Library Locale where you want to install the Measurement Studio documentation.
5. Click Install to install the documentation.
Integrated Measurement Studio help for Visual Studio 2010 and later support installs with an English (en-us) locale. If you are using the Visual Studio 2010 documentation with a different locale, the default installation of Measurement Studio documentation will not fully integrate with the Visual Studio 2010 and later documentation. Use the Help Configuration Utility to install Measurement Studio documentation for Visual Studio 2010 and later to other Microsoft documentation locales.
If you choose to view the Microsoft Visual Studio 2010 and later help online, the help viewer launches the Microsoft Developer Network (MSDN) Web site, which does not include the NI Measurement Studio Help. To view the Measurement Studio help, select Start»All Programs»National Instruments»Measurement Studio 2010 for Visual Studio 2010»Measurement Studio Documentation.

Driver Support

To use .NET class libraries that interface to National Instruments device drivers, NI-DAQmx, NI-VISA, and NI-488.2, you must install the underlying device drivers in addition to the .NET class libraries. You can run the underlying device driver installers from the NI Device Drivers DVD included with Measurement Studio. Alternatively, refer to NI Drivers and Updates on ni.com and enter Device Drivers into the search field to download the latest version of the NI Device Drivers.

Driver Support Notes

Refer to the following list for information about .NET support for NI device drivers.

Important: If you create an NI VISA Windows Application or NI VISA Class Library project or you add an NI Visa Task to an existing project, Visual Studio 2010 might crash. To work around this issue, follow these steps:
1. Verify Visual Studio is closed.
2. Open MAX by selecting Start»All Programs»National Instruments»Measurement & Automation.
3. Close MAX.
4. Rerun the Measurement Studio VISA Windows Application or Class Library project or re-add the NI Visa Task to your existing project.
The DAQ Assistant and the Instrument I/O Assistant are installed from the NI Device Drivers DVD. You must install the NI Device Drivers DVD to use the assistants.
Visual Studio 2010 support:
- The following drivers provide 32-bit and 64-bit support for Visual Studio 2010: NI-DAQmx 9.2.3 and later, NI-VISA 5.0.3 and later, and NI-488.2 2.8.1 and later.
- The following drivers do not provide support for Visual Studio 2010: NI-IMAQ, NI-IMAQdx, MAX (Measurement& Automation Explorer), and NI-SCOPE. Refer to the Measurement Studio 2010 Known Issues Web page for more information.

Installing Measurement Studio

Complete the following steps to install Measurement Studio. These steps describe a typical installation. Please carefully review all additional licensing and warning dialog boxes.

National Instruments recommends that you exit all programs before running the Measurement Studio installer. Applications that run in the background, such as virus scanning utilities, might cause the installer to take longer than necessary to complete.

Log on as Administrator or as a user with administrator privileges.
Launch Autorun.exe, either from the installation media or from the location to which you extracted the downloaded disc image. Select Install Measurement Studio.
Select Measurement Studio 2010 SP1 support for the version or versions of Visual Studio you want to install support for.
Follow the instructions that appear on the screen.

Tip You can use a spec file to programmatically control the Measurement Studio installer for a single distribution or for the entire suite. An example spec file for a single distribution is located on your installation media at <drive>:Distribution\Measurement Studio for VS20xx\Bin\template_spec.txt. For more information, refer to KnowledgeBase Article 4CJDP38M: Automating the Installation of a Single Installer on ni.com. Alternately, you can generate a spec file for the entire Measurement Studio suite. Refer to KnowledgeBase Article 4GGGDQH0: Automating the Installation of a Suited Installer on ni.com for instructions on how to generate a spec file for your suite.

Activating Measurement Studio Licenses

After you install Measurement Studio, you must use the NI Activation Wizard to activate the software. To activate Measurement Studio, you need the serial number printed on the Certificate of Ownership included in your software kit. Refer to the Licensing, Evaluation, and Activation section in the NI Measurement Studio Help for more information about how to activate Measurement Studio.

National Instruments offers a variety of Measurement Studio licenses, with certain licensed features available for each license type: Standard Edition, Professional Edition, and Enterprise Edition. Refer to the Measurement Studio Editions topic in the NI Measurement Studio Help for more information on Measurement Studio editions, and the Licensing Measurement Studio section in the NI Measurement Studio Help for more information about licensing Measurement Studio.

Tip To move to a different Measurement Studio edition, you can activate the new edition by using NI License Manager. Select Start»All Programs»NationalInstruments»NI License Manager to access NI License Manager.

For general license activation information, refer to ni.com/activate. Refer to ni.com/mstudio to purchase a Measurement Studio license. Contact a local National Instruments representative at www.ni.com/contact for more information or for questions about specific licensing needs.

Installing the Current Version of Measurement Studio over Previous Versions of Measurement Studio

You can have only one version of Measurement Studio installed on a system for each version of Visual Studio or the .NET Framework installed on the system. For example, you can have Measurement Studio 2010 SP1 for Visual Studio 2010 installed on the same system as Measurement Studio 8.6.1 for Visual Studio 2008, but you cannot have Measurement Studio 2010 SP1 for Visual Studio 2008 installed on the same system as Measurement Studio 8.6.1 for Visual Studio 2008.

If you install a newer version of Measurement Studio on a machine that has a prior version of Measurement Studio installed, the newer version installer replaces the prior version functionality, including class libraries. However, the prior version assemblies remain in the global assembly cache (GAC); therefore, applications that reference the prior version continue to use the prior version .NET assemblies.

Note NationalInstruments.Common.dll uses a publisher policy file to redirect applications to always use the newest version of NationalInstruments.Common.dll installed on the system, for each version of the .NET Framework. However, prior versions of NationalInstruments.Common.dll remain in the GAC after you install a newer version of Measurement Studio. National Instruments exerts extra effort to ensure that NationalInstruments.Common.dll is backward-compatible so that applications built against prior versions of Measurement Studio continue to work as expected.

Deployment Requirements

To deploy an application built with Measurement Studio .NET class libraries, the target computer must have a Windows 7/Vista/XP/Server 2003 and 2008 (R2 editions) operating system operating system and .NET Framework 4.0.

Getting Started with Measurement Studio 2010 SP1

For assistance in getting started with Measurement Studio 2010 SP1, refer to the Measurement Studio Overview and the Getting Started with the Measurement Studio Class Libraries topics in the NI Measurement Studio Help or refer to Getting Started with Measurement Studio or the Measurement Studio Release Notes.

For step-by-step guides to learning how to develop applications with Measurement Studio, refer to the Measurement Studio Walkthroughs section of the NI Measurement Studio Help.

Within Visual Studio, you can launch the NI Measurement Studio Help by selecting Measurement Studio»NI Measurement Studio Help.

To view the Getting Started with Measurement Studio guide or the Measurement Studio Release Notes, select Start»All Programs»National Instruments»<Measurement Studio>»Getting Started with Measurement Studio or Start»All Programs»National Instruments»<Measurement Studio>»Measurement Studio Release Notes. To view these documents, you need the free Adobe Reader. Refer to the Adobe Systems Incorporated Web site at www.adobe.com to download Adobe Reader.

Note Because Measurement Studio 2010 SP1 is a maintenance release, the Getting Started with Measurement Studio manual and the Measurement Studio Release Notes were not revised. The most recent versions of the Getting Started with Measurement Studio manual and the Measurement Studio Release Notes document Measurement Studio 2010.

Bug Fixes in Measurement Studio 2010 SP1

The following items are bugs fixed in Measurement Studio 2010 SP1.

ID	Fixed Issue	Issue Details
168274	Reading and writing data within the same loop using TDMS results in a significant performance decrease.
217352	Updating the `InteractionModeDefault` of any .NET graph while the mouse is over the graph will not update the mouse cursor.	The cursor will not update until the mouse moves off and then back onto the graph.
222524	The y-axis on a Measurement Studio graph accommodates the text length of a custom division label even if the custom division is not visible.	If you create a custom division on the y-axis with a label long enough to cause the y-axis width to grow, the axis does not return to its normal size if the custom division is not visible.
235390	Measurement Studio Boolean controls do not correctly handle the <Esc> key.	For example, when an LED or Switch has an interaction mode of `SwitchWhenReleased`, you cannot press <Esc> to cancel the change.
235391	Measurement Studio Boolean controls do not correctly handle loss of application focus.	You see this behavior if the following steps occur: You set the interaction mode of the Boolean control to `SwitchWhenReleased`. You start both the application and another small application that you can switch to. You press and hold the mouse over the Boolean control. You <Alt+Tab> to another application while still holding down the mouse. You move the mouse away from the control and release. If you complete these steps, the Boolean control is stuck in the true position. Returning the focus to the application does not correct the state of the Boolean control.
244273	A project using Measurement Studio mixed mode assemblies built against .NET Frameworks prior to .NET Framework 4 cannot run against .NET Framework 4.	If you build a Measurement Studio project that references a Measurement Studio mixed mode assembly, such as `NationalInstruments.Common.Native` in Visual Studio 2005 or 2008, and try to run the project on a machine that has only .NET Framework 4, the project will not run, even when using an app.config file forcing the application to use .NET Framework 4. The project fails to load the mixed mode assembly.
254498	Waveform, scatter, complex, and intensity graph annotations do not appear in the correct position if moved from one graph to another.
257272	`EngineeringFormatInfo.Parse` fails when used with non-English numeric separators.
276432	The Visual Studio Debugger display strings for the Measurement Studio intensity graph are not consistent with other Measurement Studio graphs.	The Debugger display string for the intensity graph shows `{PlotAreaColor={Color[Black]}}` instead of `{Plots = 1}`, like other Measurement Studio graphs.
276435	If you call the `Draw` method on a Measurement Studio annotation and the `Visible` property of the annotation is set to false, the annotation does not draw.	All other Measurement Studio user interface components draw correctly when you call `Draw`, even if the `Visible` property is set to false.
276792	The Update Project References dialog box shows an evaluation warning.	This evaluation warning displays because the Update Project References dialog box was built without properly activating a third-party software component. This warning does not mean that your copy of Measurement Studio is in the evaluation license state. Despite the evaluation warning, your project references will update successfully.
285295	You cannot evaluate Measurement Studio on Italian versions of Windows.	Attempting to run any projects built while evaluating Measurement Studio results in a `LicenseException`.
286749	If a Measurement Studio control is on a Microsoft tab control, saving the control to an image results in a poor-quality image.	If you save the image as a .png file, the image quality is poor. If you save the image as a .jpeg or .bmp file, the image is entirely black.
290486	Using a logarithmic x-axis scale on Measurement Studio graphs can cause a hang for some data sets.	This issue only happens when the lower bound of the x-axis range is <= .1000. This issue also only happens for certain data sets.
292544	Deployed Measurement Studio network variable client programs cannot use LogosXT.	A LogosXT merge module is not available to redistribute the LogosXT components.

Note Refer to the What's New section in the NI Measurement Studio Help for information about bug fixes in previous versions of Measurement Studio.

Known Issues in Measurement Studio 2010 SP1

You can access the known issues for Measurement Studio 2010 SP1 online. Refer to the Measurement Studio 2010 SP1 Known Issues Web page for a complete, up-to-date listing of known issues in Measurement Studio 2010 SP1.

Measurement Studio 2010 SP1 Incompatibilities with Previous Versions of Measurement Studio

For a complete list of incompatibilities in Measurement Studio with previous versions of Measurement Studio and otherwise supported features, including a list of obsoleted members and members that have been changed to sealed override or non-virtual, refer to the Measurement Studio Incompatibilities topic in the NI Measurement Studio Help.

2010 SP1

The NI Spy utility has been renamed NI I/O Trace. This will not affect existing projects; however, for Measurement Studio 2010 and earlier versions and versions of the NI Drivers DVD released before August 2011, the Measurement Studio menu contains a link to NI Spy. The Measurement Studio menu link has been changed to reflect the new name of the utility in Measurement Studio 2010 SP1. The NI I/O Trace menu item is available only if you have NI I/O Trace installed. Refer to the Measurement Studio Menu topic for further information.
Measurement Studio integrated tools now update outdated Measurement Studio assembly references in a project only if that project targets the version of the .NET Framework that the Measurement Studio integrated tools support. Measurement Studio integrated tools prompt you to update outdated assembly references when you open a project with outdated references. Measurement Studio integrated tools update outdated assembly references without a prompt if you use the Update Measurement Studio Project References menu item. A Measurement Studio assembly reference is considered outdated if the installed version of Measurement Studio is newer than the version in the reference.
In prior versions of Measurement Studio, Measurement Studio integrated tools updated Measurement Studio assembly references regardless of the version of the .NET Framework that the project targeted. For example, if you used Visual Studio 2010 to open a Visual Studio project with references to Measurement Studio assemblies built against .NET Framework 3.5, Measurement Studio integrated tools would prompt you to change your project to refer to the Measurement Studio assemblies built against .NET Framework 4. This behavior made it inconvenient to use newer versions of Visual Studio to develop projects that target older versions of the .NET Framework.

In Measurement Studio 2010 SP1, Measurement Studio integrated tools update Measurement Studio assembly references only if the project targets the version of the .NET Framework that the integrated tools support. For example, if you use Visual Studio 2010 to open a Visual Studio project with references to Measurement Studio assemblies built against .NET Framework 3.5, Measurement Studio integrated tools will not attempt to update the assembly references. If you use Visual Studio 2010 to open a Visual Studio project with references to Measurement Studio assemblies built against .NET Framework 4, Measurement Studio integrated tools will attempt to update the assembly references.

Complete the following steps if you want Measurement Studio integrated tools to update your Measurement Studio assembly references:
1. Right-click your project and select Properties.
2. Change the project target framework setting to the latest .NET Framework version for the Visual Studio version you are using.
3. Select Measurement Studio»Update Measurement Studio Project References .
4. Click OK to return to your project.

Notice Regarding Microsoft Silverlight Installation and Redistribution

Installing Microsoft Silverlight

Some NI components require Microsoft Silverlight. If you do not have Silverlight installed on your computer, but you do have Internet access, you can download the installer from Microsoft at http://www.microsoft.com/silverlight/. If you do not have Internet access, you can install Silverlight from this NI distribution media.

Using Microsoft Silverlight

You may not use any H.264/MPEG-4 AVC and/or VC-1 technology or codecs included in or with Microsoft Silverlight software which may be provided by NI as Third Party Software, including for the purpose of encoding or decoding video in compliance with, or making use of, the H.264/AVC visual standard or the VC-1 video standard.

Redistribution of Microsoft Silverlight

If you create and distribute software applications that contain NI components that also use Microsoft Silverlight, you may be authorized to include Silverlight in installers or on physical media as long as you comply with certain requirements. Refer to the notice.txt file in the <National Instruments>\_Legal Information\Microsoft Silverlight 4.0 directory or the NI standard End User License Agreement (EULA) located in the <National Instruments>\Common\MDF\EULADepot\NIReleased directory for more information.

Legal Information

Licenses

Measurement Studio uses third-party components. For licensing information on these third-party components, refer to the Measurement Studio 2010 Service Pack 1 FOSS notices.pdf in the [dvddrive]:\Licenses folder of your NI Measurement Studio installation media.

Copyright

Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.

Trademarks

CVI, LabVIEW, National Instruments, NI, ni.com, the National Instruments corporate logo, and the Eagle logo are trademarks of National Instruments Corporation. Refer to the Trademark Information section on ni.com/trademarks for other National Instruments trademarks.

Patents

For patents covering the National Instruments products, refer to the appropriate location: Help»Patents in your software, the patents.txt file on your DVD, or ni.com/patents.

To comment on National Instruments documentation, refer to the National Instruments Web site.