Differences between ArcGIS 10.0, 10.1, and 10.2 APIs

Compatibility Issues (Using BAGIS 10.0 add-ins on 10.1)

BAGIS Ver 2B

• 1. The map projection folder in 10.1 is different from 10.0. "Unable to locate the USA Contiguous Albers Equal Area Conic USGS.prj file." ISpatialReferenceFactory3.CreateSpatialReference method was used to get the projection parameters. This approach doesn't need a direct access to the .prj file.

  2. The other code works normally when BAGIS V2 compiled in 10.0 SDK was installed on 10.1.

  3. The Excel functions also work normally on computers with Office 2010 (Ver 14) installed.

BAGIS-H

BAGIS-P

• 1. GXCatalogClass does not work with .NET framework 3.5

     1. Cannot use an ArcCatalog dialog to select a file. Error message: 'Unable to cast object of type 'System.__ComObject' to type 'ESRI.ArcGIS.Catalog.GxCatalogClass'.

     2. Solution is to switch project to use .NET framework 4. When BAGIS-P is compiled under ArcGIS 10.0 with .NET Framework 4, the Add-In runs in both 10.0 and 10.1. See .NET Framework 4.0 - Compilation for details on how to switch a project to compile under .NET Framework 4.

.NET Add-In Build Instructions on ArcGIS 10.1, 10.2 SDK

1. Update ESRI references that have missing path ("<The system cannot find the reference specified>"). Set the value of the Specific Version property of the reference to "False."

2. Make sure to update the references for both the BAGIS project and the BAGIS_ClassLibrary project.

   1. Change the version value in the " <Target name="Desktop" version="10.0" />" statement in Config.esriaddinx to match the ArcGIS SDK version.

3. BAGIS (V2) has a few MicroSoft Excel references for Office 12. On computers with different versions of Office, please remove the other versions of references that point to "Microsoft.Office.Interop.Excel.dll."

• 1. When UPGRADING or REINSTALLING your ArcMap client you may need to change the supportedRuntime version in the ArcMap.exe config and ArcCatalog.exe config files to v4.0.30319. See this documentation from ESRI for more information.

.NET Add-In Build Instructions on ArcGIS 10.0 SDK for both ArcGIS 10.0 and 10.1

.NET Framework 4 - Compilation

• 1. Right click on the project name in the VB Solution Explorer and select Properties

  2. Click the Compile menu option

  3. Click on the Advanced Compile Options... button near the bottom

  4. Change the Target Framework (all configurations) to .NET Framework 4 and save your changes. Click through any warnings from Visual Studio. It might take a few moments for the project to restart.

  5. If you are working with an older project, you may see some error messages similar to this:

  6. Interop type XXX cannot be embedded. Use the applicable interface instead.

  7. To fix these errors, remove the "Class" suffix from the object declaration. For example: GxCatalogClass becomes GxCatalog. For more details on this error message, consult this MSDN article.

  8. You will also need to update the AddIn Language in the ESRI Config.esriaddinx configuration file.

  9. This line:

  10. <AddIn language="CLR" library="BAGIS_P.dll" namespace="BAGIS_P">

  11. Becomes:

  12. <AddIn language="CLR4.0" library="BAGIS_P.dll" namespace="BAGIS_P">

1. After making these changes, you should be able to compile and deploy the Add-In.

Embedding ArcObjects assembly in compilation

VS 2010 allows users to determine if they want to embed object types from managed assemblies by setting the "Embed Interop" property of a reference. By setting the property to "TRUE" of some assemblies, the esriaddin can work with different versions of ArcObjects assemblies that come with ArcGIS 10.0 and 10.1. For more information, see "Embedding Type from Managed Assemblies".

The two assemblies in question were Geodatabase and DataSourcesGDB. Both assemblies should be set to "TRUE" in both BAGIS(-H/-P) and BAGIS_ClassLibrary. Doing so resolves the runtime errors associated with FileGDBWorkspaceFactoryClass.

Debugging .NET Framework 4 for ArcGIS 10.0

Breakpoints and debugging features in the VB Solution stop working when debugging .NET Framework 4 code on ArcGIS 10.0 (including ArcMap, ArcCatalog, etc). The default ArcMap 10.0 supports only .NET Framework 3.5 (or earlier version) assemblies. This problem can be resolved by the following procedures:

• 1. Find the ArcMap.exe.config (or ArcCatalog.exe.config) file in the C:\Program Files (x86)\ArcGIS\Desktop10.0\Bin folder.

1. Change the version of the supportedRuntime parameter to V4.0.30319. See the edit example below.

   1. 1. <!--supportedRuntime version="v2.0.50727"/-->

      2. <supportedRuntime version="v4.0.30319"/>

      3. After changing the supportedRuntime parameter, you may receive a series of warnings about "disconnected context". These warning cause the debugger to stop as if it is at a breakpoint. You need to step over to continue debugging. This is not a problem with PSU code but rather an issue with the ESRI source code.

      4. You can turn the warnings off in the Visual Studio debugger settings

      5. From the Debug menu, select Exceptions...

      6. Expand the Managed Debugging Assistants section

      7. Uncheck the thrown checkbox for ContextSwitchDeadlock and DisconnectedContext MDA's

      8. For more information see this discussion thread