Framework and References, Common Properties, <Projectname> Property Pages Dialog Box

Use this property page dialog box to set up C++ projects with references to .NET Framework assemblies, COM components, or external projects.

Note

This property page dialog box is available only for CLR projects.

To open this property page dialog box, select References on the Project menu or on the project shortcut menu in Solution Explorer. Alternatively, you can open the property pages for your project, expand the Common Properties node, and then select References.

How to: Open Project Property Pages

Targeted Framework

Applications created by using Visual Studio 2008 can specify which version of the .NET Framework they should target. By default, the targeted framework is set to .NET Framework 3.5 for new projects. If your project must be able to run on computers that do not have .NET Framework 3.5 installed, select either .NET Framework 3.0 or .NET Framework 2.0. The targeted framework will use .NET Framework 2.0 for projects that were created by using an earlier version of Visual Studio.

References

The References pane displays a list of all the components that your project currently references, such as .NET Framework assemblies, COM components, and external projects.

  • Add New Reference
    Opens the Add Reference dialog box. For more information, see Add Reference Dialog Box.

  • Remove Reference
    Deletes the reference to the assembly that is selected in the References list.

ActiveX Reference Properties

Note

ActiveX reference properties are available only for references to COM components. These properties are displayed only when a COM component is selected in the References pane. These properties are not modifiable.

  • Control Full Path
    The full path of the referenced control.

  • Control GUID
    The GUID for the ActiveX control.

  • Control Version
    The version of the referenced ActiveX control.

  • Type Library Name
    The name of the referenced type library.

  • Wrapper Tool
    The tool that is used to build the interop assembly from the referenced COM library or ActiveX control.

Assembly Reference Properties

Note

Assembly reference properties are available only for references to .NET Framework assemblies. These properties are displayed only when a .NET Framework assembly is selected in the References pane. These properties are not modifiable.

  • Minimal Framework version
    Displays the minimal version of the .NET Framework that the project must target in order to reference the assembly. For more information, see the section Targeted Framework earlier in this topic.

  • Relative Path
    The relative path from the project directory to the referenced assembly.

Build Properties

The following properties enable you to specify how to build with references.

  • Copy Local
    Specifies whether to automatically copy the referenced assembly to the target location during a build.

  • Copy Local Dependencies
    Specifies whether to automatically copy the referenced assembly's non-system dependencies to the target location during a build. Only used if Copy Local is true.

  • Copy Local Satellite Assemblies
    Specifies whether to automatically copy the referenced assembly's satellite assemblies to the target location during a build. Only used if Copy Local is true.

  • Use Dependencies In Build
    Specifies that the dependencies of this assembly are used in the build process. If true, this assembly's dependencies will be used on the compiler's command line during the build.

  • Use In Build
    Specifies that this assembly is used in the build process. If true, the assembly will be used on the compiler's command line during the build.

Reference Properties

The following properties are not modifiable.

  • Assembly Name
    Indicates the assembly name for the referenced assembly.

  • Culture
    Indicates the culture of the selected reference.

  • Description
    Displays the description of the selected reference.

  • Full Path
    Indicates the directory path of the referenced assembly.

  • Identity
    Indicates the full path for the .NET Framework assemblies. Indicates the GUID for COM components.

  • Label
    Indicates the label of the reference.

  • Name
    Indicates the name of the reference.

  • Public Key Token
    Indicates the public key token that is used to identify the referenced assembly.

  • Strong Name
    true if the referenced assembly has a strong name. A strong named assembly is uniquely versioned.

  • Version
    Indicates the version of the referenced assembly.

Additional reference search paths

The Additional reference search paths pane displays a list of additional paths to search when the compiler resolves assembly references.

  • Add Path
    Opens the Add Reference Search Path dialog box, in which you can add search paths. For more information, see Add Reference Search Path Dialog Box.

  • Remove Path
    Removes the selected search path from the list of reference search paths.

  • Move Up
    Moves the selected search path up in the list.

  • Move Down
    Moves the selected search path down in the list.

See Also

Reference

Property Pages (C+)