ArcGIS Engine Developer Guide

.NET APPLICATION PROGRAMMING INTERFACE
System.Runtime.InteropServices.Marshal.ReleaseComObject to decrement the reference
count, allowing the application to terminate cleanly. The StyleGallery is one such
object, and the following example documents how to handle references to this
class.
[VB.NET]
Sub Main()
Dim styCls As ESRI.ArcGIS.Display.IStyleGallery = New
ESRI.ArcGIS.Framework.StyleGalleryClass
' Use the StyleGalleryClass here ...
Release(styCls)
End Sub
Sub Release(ByVal comObj As Object)
Dim refsLeft As Integer = 0
Do
refsLeft = System.Runtime.InteropServices.Marshal.ReleaseComObject(comObj)
Loop While (refsLeft > 0)
End Sub
[C#]
private void MyFunction()
{
ESRI.ArcGIS.Display.IStyleGallery styCls = new
ESRI.ArcGIS.Framework.StyleGalleryClass() as
ESRI.ArcGIS.Display.IStyleGallery;
// Use the StyleGalleryClass here ...
Release(styCls as object);
}
void Release(object comObj)
{
int refsLeft = 0;
do
{
refsLeft = Marshal.ReleaseComObject(comObj);
}
while (refsLeft > 0);
}
This section does not address licensing considerations
and is intended only to illustrate the
possibilities of server application development
using the .NET API. While the ArcGIS Engine
Developer Kit can be used to develop applications
that run on single-use computers and that
may or may not leverage ArcSDE-, ArcGIS
Server-, or ArcIMS-based services, custom
components deployed on a server require an
ArcGIS Server license. Contact your ESRI
regional office or international distributor for
more information.
Working with geodatabase cursors in ArcGIS Server
Some objects that you can create in a server context may lock or use resources
that the object frees only in its destructor. For example, a geodatabase cursor may
acquire a shared schema lock on a file-based feature class or table on which it is
based or may hold on to an SDE stream.
While the shared schema lock is in place, other applications can continue to query
or update the rows in the table, but they cannot delete the feature class or modify
its schema. In the case of file-based data sources, such as shapefiles, update
cursors acquire an exclusive write lock on the file, which will prevent other
applications from accessing the file for read or write. The effect of these locks is
that the data may be unavailable to other applications until all of the references
on the cursor object are released.
176 • ArcGIS Engine Developer Guide