WellKnownServiceTypeEntry Class

.NET Framework (current version)
 

Holds values for an object type registered on the service end as a server-activated type object (single call or singleton).

Namespace:   System.Runtime.Remoting
Assembly:  mscorlib (in mscorlib.dll)

System::Object
  System.Runtime.Remoting::TypeEntry
    System.Runtime.Remoting::WellKnownServiceTypeEntry

C#
C++
F#
VB
Copy 
[ComVisibleAttribute(true)]
public ref class WellKnownServiceTypeEntry : TypeEntry

NameDescription
System_CAPS_pubmethodWellKnownServiceTypeEntry(String^, String^, String^, WellKnownObjectMode)

Initializes a new instance of the WellKnownServiceTypeEntry class with the given type name, assembly name, object URI, and WellKnownObjectMode.

System_CAPS_pubmethodWellKnownServiceTypeEntry(Type^, String^, WellKnownObjectMode)

Initializes a new instance of the WellKnownServiceTypeEntry class with the given Type, object URI, and WellKnownObjectMode.

NameDescription
System_CAPS_pubpropertyAssemblyName

Gets the assembly name of the object type configured to be a remote-activated type.(Inherited from TypeEntry.)

System_CAPS_pubpropertyContextAttributes

Gets or sets the context attributes for the server-activated service type.

System_CAPS_pubpropertyMode

Gets the WellKnownObjectMode of the server-activated service type.

System_CAPS_pubpropertyObjectType

Gets the Type of the server-activated service type.

System_CAPS_pubpropertyObjectUri

Gets the URI of the well-known service type.

System_CAPS_pubpropertyTypeName

Gets the full type name of the object type configured to be a remote-activated type.(Inherited from TypeEntry.)

NameDescription
System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns the type name, assembly name, object URI and the WellKnownObjectMode of the server-activated type as a String.(Overrides Object::ToString().)

Server-activated object types can be either single call or singleton. If an object type is single call, a new instance of it is created each time a call from the client comes in. All calls to a singleton object are handled by one instance of that object.

Any client that knows the URI of this object can obtain a proxy for this object by registering the channel it prefers with ChannelServices and activating the object by calling new or Activator::GetObject.

It is important to note that the remote object itself is not created by the registration process. This only happens when a client attempts to call a method on the object or activates the object from the client side.

For a more detailed description of server-activated objects and remote object activation, see [<topic://cpconActivation>].

C#
C++
VB
Copy 
#using <System.Runtime.Remoting.dll>
#using <System.dll>
#using <WellKnownServiceTypeEntry_Share.dll>

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Http;

int main()
{
   // Create a 'HttpChannel' object and register it with the 
   // channel services.
   ChannelServices::RegisterChannel( gcnew HttpChannel( 8086 ) );

   // Record the 'HelloServer' type as 'Singleton' well-known type.
   WellKnownServiceTypeEntry^ myWellKnownServiceTypeEntry = gcnew WellKnownServiceTypeEntry( HelloServer::typeid,"SayHello",WellKnownObjectMode::Singleton );

   // Register the remote object as well-known type.
   RemotingConfiguration::RegisterWellKnownServiceType( myWellKnownServiceTypeEntry );

   // Retrieve object types registered on the service end 
   // as well-known types.
   array<WellKnownServiceTypeEntry^>^myWellKnownServiceTypeEntryCollection = RemotingConfiguration::GetRegisteredWellKnownServiceTypes();
   Console::WriteLine( "The 'WellKnownObjectMode' of the remote object : {0}", myWellKnownServiceTypeEntryCollection[ 0 ]->Mode );
   Console::WriteLine( "The 'WellKnownServiceTypeEntry' object: {0}", myWellKnownServiceTypeEntryCollection[ 0 ] );
   Console::WriteLine( "Started the Server, Hit <enter> to exit..." );
   Console::ReadLine();
}

.NET Framework
Available since 1.1

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

Return to top
Show: