This document is archived and information here might be outdated.  Recommended version.

Add ArcGIS Reference dialog box (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > Visual Studio integration > Add ArcGIS Reference dialog box

Add ArcGIS Reference dialog box

The Add ArcGIS Reference dialog box allows you to add references to ArcGIS assemblies in a project based on product, feature, or functional area.

In this topic

References tab

To use the References tab on the Add ArcGIS Reference dialog box, choose Add ArcGIS Reference from the Project menu. Alternatively, right-click the References or Project node in Solution Explorer and choose Add ArcGIS Reference. The References tab is also an option in the ArcGIS Project Wizard. See the following screen shot:

Assemblies list

The assemblies list shows all the ArcGIS assemblies available for referencing. To add assemblies, select the required assemblies in the list, and click the Add button to include those assemblies in the Selected Assemblies list. Context menu commands are also available to batch select assemblies in this list. See the following screen shot:
The contents of this list changes depending on the settings of the Filter by option. The list is in alphabetical order or grouped by category, depending on the setting in the Group assemblies option.

Group assemblies option

Choose this option to show the available assemblies, which can be listed alphabetically or grouped by product, feature, or functional area; the order depends on the current filter. If the assemblies are categorized, some assemblies can appear in the list under more than one category. For example, the ESRI.ArcGIS.ADF assembly can be listed under Desktop, Engine, Server, and so on. See the following screen shot:

Filter by option

By changing the filter, you can restrict the listed assemblies on the dialog box. To change the assembly filter, click the filter icon and select Products, Product Features, or Building Blocks from the drop-down list. See the following screen shot:

Filter types
This section describes each filter type.

Selected assemblies list

This list shows all the assemblies that are added as references to your project when you click the Finish button. The Type column indicates with an icon if a selected assembly is added, has already been referenced in the project, or cannot be found. To remove assemblies from the list, select the assemblies in the list and click the Remove button. See the following explanation of each icon:

Namespaces tab 

The Namespaces tab is used with the Insert ArcGIS Using Directives command on the code editor context menu. This command inserts import and using statements to the top of the code file for the selected namespaces. See the following screen shot:
The first time you use the Insert ArcGIS Using Directives command in the code editor context menu, a dialog box might appear with the following message:
ArcGIS Using Directives
You have not selected any ESRI.ArcGIS namespaces to insert by this command yet. Do you want to do it now?
Yes No
If you click Yes, the Add ArcGIS Reference dialog box opens. You can add ESRI.ArcGIS Assemblies under the References tab, then select assemblies under the Namespaces tab to insert Using (C#) or Imports (VB .NET) directives into your code. When this is done, you cannot re-open the Add ArcGIS Reference dialog box from the Insert ArcGIS Using Directives context menu - only adds Esri directives to the top of your code editor. To re-open the Add ArcGIS Reference dialog box and change the ESRI.ArcGIS Assemblies that are specified for directive insertion, access it via Solution Explorer or by choosing Add ArcGIS Reference from the Project menu.
Importing a namespace allows you to use elements (for example, classes, interfaces, and enumerators) from that namespace in your code without fully qualifying the type name. For example, to implement a command with the ICommand interface in the ESRI.ArcGIS.SystemUI assembly, you can import the ESRI.ArcGIS.SystemUI namespace and refer to the interfaces as ICommand. See the following code example:
Public Class MyCommand
    Implements ESRI.ArcGIS.SystemUI.ICommand
End Class
public class MyCommand: ESRI.ArcGIS.SystemUI.ICommand
Insert an import or using statement to the code file. See the following code example:
Imports ESRI.ArcGIS.SystemUI

Public Class MyCommand
    Implements ICommand
End Class
using ESRI.ArcGIS.SystemUI;

public class MyCommand: ICommand

Selected References list

This list shows all the existing ArcGIS assemblies already added to the project (Existing References) and any new assemblies you have selected on the References tab (Candidates). You can delete existing references from your project by selecting the assembly and clicking the Remove button.
The assembly is marked with a red X to indicate it will be removed when the Finish button is clicked. If you select an assembly that has been marked to be removed, the Remove button changes to Unremove so you can revert the change. See the following screen shot:
Available namespaces list
This list shows all the available namespaces included in the ArcGIS assembly references. Check the namespaces to be inserted with the Insert ArcGIS Using Directives command. The checked namespaces are saved with the project. If your current project is in VB .NET, the imported namespaces project property is updated. 
The Options button is only enabled in a C# project. When the Options button is clicked, the Options dialog box opens, and you can automatically add using statements when a new item is added to the project.

See Also:

ArcGIS Visual Studio IDE Integration Framework for extending ArcObjects
ArcGIS Project Wizard

Additional Requirements
  • ArcGIS Visual Studio integrated development environment (IDE) Integration Framework for Visual Studio.