System.EnterpriseServices N ...


.NET Framework Class Library
ServicedComponent Class

Represents the base class of all classes using COM+ services.

Namespace:  System.EnterpriseServices
Assembly:  System.EnterpriseServices (in System.EnterpriseServices.dll)
Syntax

Visual Basic (Declaration)
<SerializableAttribute> _
Public MustInherit Class ServicedComponent _
    Inherits ContextBoundObject _
    Implements IRemoteDispatch, IDisposable, IServicedComponentInfo
Visual Basic (Usage)
Dim instance As ServicedComponent
C#
[SerializableAttribute]
public abstract class ServicedComponent : ContextBoundObject, 
    IRemoteDispatch, IDisposable, IServicedComponentInfo
Visual C++
[SerializableAttribute]
public ref class ServicedComponent abstract : public ContextBoundObject, 
    IRemoteDispatch, IDisposable, IServicedComponentInfo
JScript
public abstract class ServicedComponent extends ContextBoundObject implements IRemoteDispatch, IDisposable, IServicedComponentInfo
Remarks

Under certain conditions, a class that is derived from ServicedComponent that runs in a COM+ application may stop responding. This problem is caused by an Activity deadlock. Activities can deadlock on multithreaded applications because of an asynchronous cleanup of component references. To work around this problem, call the Dispose method when you complete work with objects derived from ServicedComponent. For more information, see http://support.microsoft.com/default.aspx?scid=kb;en-us;327443.

NoteNote:

Client code must call Dispose on serviced components to ensure proper operation.

Examples

The following code example demonstrates how to expose a class as a configured COM component.

C#
using System;
using System.EnterpriseServices;

[assembly: ApplicationName("Calculator")]
[assembly: ApplicationActivation(ActivationOption.Library)]
[assembly: System.Reflection.AssemblyKeyFile("Calculator.snk")]
public class Calculator : ServicedComponent
{
    public int Add (int x, int y)
    {
        return(x+y);
    }
}
Visual C++
[assembly:ApplicationName("Calculator")];
[assembly:ApplicationActivation(ActivationOption::Library)];
[assembly:System::Reflection::AssemblyKeyFile("Calculator.snk")];
public ref class Calculator: public ServicedComponent
{
public:
   int Add( int x, int y )
   {
      return (x + y);
   }

};

CPP_OLD
[assembly: ApplicationName(S"Calculator")]
[assembly: ApplicationActivation(ActivationOption::Library)]
[assembly: System::Reflection::AssemblyKeyFile(S"Calculator.snk")];

public __gc class Calculator : public ServicedComponent {
public:
  int Add (int x, int y) {
    return(x+y);
  }
};

To deploy this class as a configured COM component, you must generate a strong key, compile the class as a library, and register the library. These three steps are accomplished by the following three commands.

 sn -k Calculator.snk
 csc /t:library Calculator.cs
 regsvcs Calculator.dll
Inheritance Hierarchy

System..::.Object
  System..::.MarshalByRefObject
    System..::.ContextBoundObject
      System.EnterpriseServices..::.ServicedComponent
        System.EnterpriseServices.CompensatingResourceManager..::.Compensator
        System.EnterpriseServices..::.RegistrationHelperTx
Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
See Also

Reference

Tags :


Page view tracker