PROBLEM

Microsoft .NET Framework applications explicitly manage references to remote COM objects

Last Published: April 25, 2020

Description

Working with ArcGIS Server in a Microsoft .NET Framework application often requires implementing a number of programming patterns to manage remote COM object resources. In general, three techniques enable the release of a COM object and its reference in .NET:

1. Use the IDisposable pattern to explicitly release server contexts by implementing a custom ESRI class, WebObject, in a using block (C#) or try/catch block (VB).
2. Periodically invoke garbage collection throughout an application's lifetime.
3. Call ManageLifetime() for every COM object instance created in an application.

All patterns work, but require a significant amount of additional code and degrade application performance.

Additional information on these patterns and their implementation is provided here: Managing ArcGIS Server Resources

Cause

The Microsoft .NET Framework 1.1 garbage collection mechanism has a bug that affects creating and managing references to COM objects on a remote server (DCOM). Since ArcGIS Server is highly dependent on DCOM communication, this bug affects all aspects of using fine-grained ArcObjects in ArcGIS Server with the Microsoft .NET Framework. It causes COM objects that are not explicitly released with calls to Marshal.ReleaseComObject() or Garbage Collection to accumulate on the DCOM server. The server periodically tries to ping clients to see whether the COM objects should be kept alive. As the number of unreleased objects increases, the pings take longer and longer and eventually incapacitate the server.

Solution or Workaround

Explicitly managing references to remote COM objects is not required if the following requirements are met and/or hotfixes are applied: Microsoft .NET-COM HotFix

A summary of the hotfix information is provided below:

---Microsoft .NET Framework---
Version 1.1 service pack 1 must be installed before applying the hotfix. Version 2.0 already includes the hotfix.

Install the version 1.1 sp1 hotfix on machines where your ArcGIS Server for the Microsoft .NET Framework applications will run.

---Operating Systems---
Windows 2000, Windows XP (no service packs), Windows XP sp1, and Windows 2003 (no service packs) must install the hotfix. Windows 2003 Server sp1 and Windows XP sp2 already include the hotfix.

Install the operating system hotfix on machines where an ArcGIS Server - Server Object Container process (ArcSOC.exe) will run.

Article ID:000008518

Software:
  • ArcGIS Server

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options

Discover more on this topic