IMethodMessage Interface

.NET Framework (current version)

Defines the method message interface.

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

Syntax

[ComVisibleAttribute(true)]
public interface class IMethodMessage : IMessage

Properties

	Name	Description
	ArgCount	Gets the number of arguments passed to the method.
	Args	Gets an array of arguments passed to the method.
	HasVarArgs	Gets a value indicating whether the message has variable arguments.
	LogicalCallContext	Gets the LogicalCallContext for the current method call.
	MethodBase	Gets the MethodBase of the called method.
	MethodName	Gets the name of the invoked method.
	MethodSignature	Gets an object containing the method signature.
	Properties	Gets an IDictionary that represents a collection of the message's properties.(Inherited from IMessage.)
	TypeName	Gets the full Type name of the specific object that the call is destined for.
	Uri	Gets the URI of the specific object that the call is destined for.

Methods

	Name	Description
	GetArg(Int32)	Gets a specific argument as an Object.
	GetArgName(Int32)	Gets the name of the argument passed to the method.

Remarks

A method message is used to send information to and from remote methods. For example, messages used for remote method calls implement the IMethodMessage interface.

Examples

The following example code shows a custom proxy that overrides RealProxy.Invoke in order to write the message information to the console and return immediately without making a remote call.

C++

// This class requires full trust
[PermissionSetAttribute(SecurityAction::Demand, Name = "FullTrust")]
public ref class MyProxyClass: public RealProxy
{
private:
   Object^ myObjectInstance;
   Type^ myType;

public:
   MyProxyClass( Type^ argType )
      : RealProxy( argType )
   {
      myType = argType;
      myObjectInstance = Activator::CreateInstance( argType );
   }

   // Overriding the Invoke method of RealProxy.
   virtual IMessage^ Invoke( IMessage^ message ) override
   {
      IMethodMessage^ myMethodMessage = dynamic_cast<IMethodMessage^>(message);
      Console::WriteLine( "**** Begin Invoke ****" );
      Console::WriteLine( "\tType is : {0}", myType );
      Console::WriteLine( "\tMethod name : {0}", myMethodMessage->MethodName );
      for ( int i = 0; i < myMethodMessage->ArgCount; i++ )
      {
         Console::WriteLine( "\tArgName is : {0}", myMethodMessage->GetArgName( i ) );
         Console::WriteLine( "\tArgValue is: {0}", myMethodMessage->GetArg( i ) );

      }
      if ( myMethodMessage->HasVarArgs )
            Console::WriteLine( "\t The method have variable arguments!!" );
      else
            Console::WriteLine( "\t The method does not have variable arguments!!" );


      // Dispatch the method call to the real Object*.
      Object^ returnValue = myType->InvokeMember( myMethodMessage->MethodName, BindingFlags::InvokeMethod, nullptr, myObjectInstance, myMethodMessage->Args );
      Console::WriteLine( "**** End Invoke ****" );

      // Build the return message to pass back to the transparent proxy.
      ReturnMessage^ myReturnMessage = gcnew ReturnMessage( returnValue,nullptr,0,nullptr,dynamic_cast<IMethodCallMessage^>(message) );
      return myReturnMessage;
   }
};

Version Information

.NET Framework
Available since 1.1