This documentation is archived and is not being maintained.

IMethodMessage Interface

Defines the method message interface.

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

<ComVisibleAttribute(True)> _
Public Interface IMethodMessage _
	Inherits IMessage
Dim instance As IMethodMessage

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.

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.

<PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
Public Class MyProxyClass
   Inherits RealProxy
   Private myObjectInstance As Object = Nothing 
   Private myType As Type = Nothing 

   Public Sub New(argType As Type)
      myType = argType
      myObjectInstance = Activator.CreateInstance(argType)
   End Sub 'New 

   ' Overriding the Invoke method of RealProxy. 
   Public Overrides Function Invoke(message As IMessage) As IMessage
      Dim myMethodMessage As IMethodMessage = CType(message, IMethodMessage)

      Console.WriteLine("**** Begin Invoke ****")
      Console.WriteLine(ControlChars.Tab + "Type is : " + myType.ToString())
      Console.WriteLine(ControlChars.Tab + "Method name : " + myMethodMessage.MethodName)

      Dim i As Integer 
      For i = 0 To myMethodMessage.ArgCount - 1
         Console.WriteLine(ControlChars.Tab + "ArgName is : " + myMethodMessage.GetArgName(i))
         Console.WriteLine(ControlChars.Tab + "ArgValue is: " + myMethodMessage.GetArg(i))
      Next i

      If myMethodMessage.HasVarArgs Then
         Console.WriteLine(ControlChars.Tab + " The method have variable arguments!!")
         Console.WriteLine(ControlChars.Tab + " The method does not have variable arguments!!")
      End If  
      ' Dispatch the method call to the real object. 
      Dim returnValue As Object = myType.InvokeMember(myMethodMessage.MethodName, _
                     BindingFlags.InvokeMethod, Nothing, myObjectInstance, myMethodMessage.Args)
      Console.WriteLine("**** End Invoke ****")

      ' Build the return message to pass back to the transparent proxy. 
      Dim myReturnMessage As New ReturnMessage(returnValue, Nothing, 0, Nothing, _
                                                         CType(message, IMethodCallMessage))
      Return myReturnMessage
   End Function 'Invoke
End Class 'MyProxyClass
public __gc class MyProxyClass : public RealProxy 
	Object* myObjectInstance;
	Type* myType;

	MyProxyClass(Type* argType) : RealProxy(argType) 
		myType = argType;
		myObjectInstance = Activator::CreateInstance(argType);

	// Overriding the Invoke method of RealProxy.
	IMessage* Invoke(IMessage* message) 
		IMethodMessage* myMethodMessage = dynamic_cast<IMethodMessage*>(message);

		Console::WriteLine(S"**** Begin Invoke ****");
		Console::WriteLine(S"\tType is : {0}", myType);
		Console::WriteLine(S"\tMethod name : {0}", myMethodMessage->MethodName);

		for (int i=0; i < myMethodMessage->ArgCount; i++) 
			Console::WriteLine(S"\tArgName is : {0}", myMethodMessage->GetArgName(i));
			Console::WriteLine(S"\tArgValue is: {0}", myMethodMessage->GetArg(i));

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

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

		// Build the return message to pass back to the transparent proxy.
		ReturnMessage* myReturnMessage = new ReturnMessage(returnValue, 0, 0, 0,
		return myReturnMessage;

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.

.NET Framework

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