System.Runtime.Remoting.WellKnownServiceTypeEntry Class

Assembly: Mscorlib.dll
Namespace: System.Runtime.Remoting
Summary
Holds values for an object type registered on the service end as a well-known type object (single call or singleton).
C# Syntax:
public class WellKnownServiceTypeEntry : TypeEntry
Remarks
Well-known 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 well-known objects and remote object activation, see the conceptual topic at MSDN: activation.

See also:
System.Runtime.Remoting Namespace | RemotingConfiguration.RegisterWellKnownServiceType | MSDN: serveractivation

System.Runtime.Remoting.WellKnownServiceTypeEntry Member List:

Public Constructors
ctor #1 Overloaded:
.ctor(Type type, string objectUri, WellKnownObjectMode mode)

Initializes a new instance of the WellKnownServiceTypeEntry class with the given Type, object URI, and WellKnownObjectMode.
ctor #2 Overloaded:
.ctor(string typeName, string assemblyName, string objectUri, WellKnownObjectMode mode)

Initializes a new instance of the WellKnownServiceTypeEntry class with the given type name, assembly name, object URI, and WellKnownObjectMode.
Public Properties
AssemblyName
(inherited from System.Runtime.Remoting.TypeEntry)
Read-write

See base class member description: System.Runtime.Remoting.TypeEntry.AssemblyName


Gets the assembly name of the object type configured to be a remote activated type.
ContextAttributes Read-write

Gets or sets the context attributes for the well-known service type.
Mode Read-only

Gets the WellKnownObjectMode of the well-known service type.
ObjectType Read-only

Gets the Type of the well-known service type.
ObjectUri Read-only

Gets the URI of the well known service type.
TypeName
(inherited from System.Runtime.Remoting.TypeEntry)
Read-write

See base class member description: System.Runtime.Remoting.TypeEntry.TypeName


Gets the full type name of the object type configured to be a remote activated type.
Public Methods
Equals
(inherited from System.Object)
See base class member description: System.Object.Equals

Derived from System.Object, the primary base class for all objects.
GetHashCode
(inherited from System.Object)
See base class member description: System.Object.GetHashCode

Derived from System.Object, the primary base class for all objects.
GetType
(inherited from System.Object)
See base class member description: System.Object.GetType

Derived from System.Object, the primary base class for all objects.
ToString Overridden:
Returns the type name, assembly name, object URI and the WellKnownObjectMode of the well-known server activated type as a String.
Protected Methods
Finalize
(inherited from System.Object)
See base class member description: System.Object.Finalize

Derived from System.Object, the primary base class for all objects.
MemberwiseClone
(inherited from System.Object)
See base class member description: System.Object.MemberwiseClone

Derived from System.Object, the primary base class for all objects.

Hierarchy:


System.Runtime.Remoting.WellKnownServiceTypeEntry Member Details

Overloaded ctor #1
Summary
Initializes a new instance of the WellKnownServiceTypeEntry class with the given Type, object URI, and WellKnownObjectMode.
C# Syntax:
public WellKnownServiceTypeEntry(
   Type type,
   string objectUri,
   WellKnownObjectMode mode
);
Parameters:

type

The Type of the well-known service type object.

objectUri

The URI of the well-known type.

mode

The WellKnownObjectMode of the type, which defines how the object is activated.

Return to top


Overloaded ctor #2
Summary
Initializes a new instance of the WellKnownServiceTypeEntry class with the given type name, assembly name, object URI, and WellKnownObjectMode.
C# Syntax:
public WellKnownServiceTypeEntry(
   string typeName,
   string assemblyName,
   string objectUri,
   WellKnownObjectMode mode
);
Parameters:

typeName

The full type name of the well-known service type.

assemblyName

The assembly name of the well-known service type.

objectUri

The URI of the well-known object.

mode

The WellKnownObjectMode of the type, which defines how the object is activated.

Return to top


Property: AssemblyName (read-write)
Inherited
See base class member description: System.Runtime.Remoting.TypeEntry.AssemblyName

Summary
Gets the assembly name of the object type configured to be a remote activated type.
C# Syntax:
public string AssemblyName {get; set;}

Return to top


Property: ContextAttributes (read-write)
Summary
Gets or sets the context attributes for the well-known service type.
C# Syntax:
public IContextAttribute[] ContextAttributes {get; set;}
Remarks
Context attributes provide context properties that, when added to a context, can enforce policies such as synchronization and transactions.

Note At the moment this indexer is not implemented and operations on it will not produce any results.
See also:
Context | ContextAttribute | ContextProperty | IContextAttribute

Return to top


Property: Mode (read-only)
Summary
Gets the WellKnownObjectMode of the well-known service type.
C# Syntax:
public WellKnownObjectMode Mode {get;}

Return to top


Property: ObjectType (read-only)
Summary
Gets the Type of the well-known service type.
C# Syntax:
public Type ObjectType {get;}

Return to top


Property: ObjectUri (read-only)
Summary
Gets the URI of the well known service type.
C# Syntax:
public string ObjectUri {get;}

Return to top


Property: TypeName (read-write)
Inherited
See base class member description: System.Runtime.Remoting.TypeEntry.TypeName

Summary
Gets the full type name of the object type configured to be a remote activated type.
C# Syntax:
public string TypeName {get; set;}

Return to top


Method: Equals(
   object obj
)
Inherited
See base class member description: System.Object.Equals
C# Syntax:
public virtual bool Equals(
   object obj
);

For more information on members inherited from System.Object click on the link above.

Return to top


Method: Finalize()
Inherited
See base class member description: System.Object.Finalize
C# Syntax:
~WellKnownServiceTypeEntry();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: GetHashCode()
Inherited
See base class member description: System.Object.GetHashCode
C# Syntax:
public virtual int GetHashCode();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: GetType()
Inherited
See base class member description: System.Object.GetType
C# Syntax:
public Type GetType();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: MemberwiseClone()
Inherited
See base class member description: System.Object.MemberwiseClone
C# Syntax:
protected object MemberwiseClone();

For more information on members inherited from System.Object click on the link above.

Return to top


Overridden Method: ToString()
Summary
Returns the type name, assembly name, object URI and the WellKnownObjectMode of the well-known server activated type as a String.
C# Syntax:
public override string ToString();
Return Value:
The type name, assembly name, object URI and the WellKnownObjectMode of the well-known server activated type as a String.

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.