About the Add ArcGIS Reference dialog box

SummaryThis dialog box allows you to add references to ArcGIS assemblies in a project, which is based on product, functional, or feature area.

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

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 the Solution Explorer and choose Add ArcGIS Reference. The References tab is also shown as a page in the ArcGIS Project Wizard. See the following screen shot of the References tab on the Add ArcGIS Reference dialog box:
 
 

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, as 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
The following explains each filter type:
 
Products—The Products filter restricts the assemblies list to Desktop, Engine, or Server products. See the following screen shot:


 
Product Features—The Product Features filter selects groups of assemblies associated with Desktop, Engine, or Server products and their extensions. For example, you can restrict the assemblies listed to only ArcCatalog and ArcCatalog extensions if you are developing for the ArcGIS Desktop ArcCatalog or to just core Engine assemblies. See the following screen shot:



In addition, you can use the product subfilter to enable or disable each product drop-down menu. See the following screen shot:

 
 
Building Blocks—The Building Block filter selects groups of assemblies associated with particular areas of functionality. For example, you can restrict the assemblies listed to only those associated with accessing the geodatabase. In addition, by selecting the product subfilter, you can further restrict the assemblies by product. See the following screen shot:



The Quick Select option from the Building Blocks drop-down menu can be used for batch checking on and off functional areas from the Batch Select dialog box.

Selected assemblies list
This list shows all the assemblies 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:
 
 
Importing a namespace allows you to use elements (for example, classes, interfaces, enumerators) from that namespace in your code without fully qualifying the type name. For example, if you want 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:
 

[VB.NET] 
Public Class MyCommand 
    Implements ESRI.ArcGIS.SystemUI.ICommand
    …
End Class

[C#] 
public class MyCommand : ESRI.ArcGIS.SystemUI.ICommand
{
    …
}
Insert an import or using statement to the code file. See the following code example:
[VB.NET] 
Imports ESRI.ArcGIS.SystemUI

Public Class MyCommand 
    Implements ICommand
    …
End Class

[C#] 
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 appears and you can automatically add using statements when a new item is added to the project.


See Also:

Overview: ArcGIS Visual Studio IDE Integration Framework
About the ArcGIS Project Wizard