IMethodMessage

.NET Framework クラス ライブラリ リファレンス

IMethodMessage インターフェイス

メソッド メッセージのインターフェイスを定義します。

名前空間: System.Runtime.Remoting.Messaging
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As IMethodMessage

C#

[ComVisibleAttribute(true)] 
public interface IMethodMessage : IMessage

C++

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

J#

/** @attribute ComVisibleAttribute(true) */ 
public interface IMethodMessage extends IMessage

JScript

ComVisibleAttribute(true) 
public interface IMethodMessage extends IMessage

解説

メソッド メッセージは、リモートのメソッドに情報を送信したり、リモートのメソッドから情報を受信したりするために使用します。たとえば、リモートのメソッド呼び出しに使用されるメッセージは、IMethodMessage インターフェイスを実装します。

使用例

RealProxy.Invoke をオーバーライドして、メッセージの情報をコンソールに書き込むカスタム プロキシについては、次のコード例を参照してください。この例では、リモート呼び出しを実行せずすぐに制御を戻します。

Visual Basic

<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)
      MyBase.New(argType)
      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!!")
      Else
         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

C#

[PermissionSet(SecurityAction.Demand, Name="FullTrust")]
public class MyProxyClass : RealProxy
{
   private Object  myObjectInstance  = null;
   private Type    myType      = null;

   public MyProxyClass(Type argType) : base(argType)
   {
      myType = argType;
      myObjectInstance = Activator.CreateInstance(argType);
   }

   // Overriding the Invoke method of RealProxy.
   public override IMessage Invoke(IMessage message)
   {
      IMethodMessage myMethodMessage = (IMethodMessage)message;

      Console.WriteLine("**** Begin Invoke ****");
      Console.WriteLine("\tType is : " + myType);
      Console.WriteLine("\tMethod name : " +  myMethodMessage.MethodName);

      for (int i=0; i < myMethodMessage.ArgCount;
 i++)
      {
         Console.WriteLine("\tArgName is : " + myMethodMessage.GetArgName(i));
         Console.WriteLine("\tArgValue is: " + 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,
 null,
                                           myObjectInstance, myMethodMessage.Args
 );
      Console.WriteLine("**** End Invoke ****");

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

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;
   }
};

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
IMethodMessage メンバ
System.Runtime.Remoting.Messaging 名前空間

IMethodMessage プロパティ

パブリック プロパティ

	名前	説明
	ArgCount	メソッドに渡された引数の数を取得します。
	Args	メソッドに渡された引数の配列を取得します。
	HasVarArgs	メッセージに可変個の引数があるかどうかを示す値を取得します。
	LogicalCallContext	現在のメソッド呼び出しの LogicalCallContext を取得します。
	MethodBase	呼び出されたメソッドの MethodBase を取得します。
	MethodName	呼び出されたメソッドの名前を取得します。
	MethodSignature	メソッド シグネチャを格納しているオブジェクトを取得します。
	TypeName	呼び出しの送信先となる特定のオブジェクトの完全な Type 名を取得します。
	Uri	呼び出しの送信先となる特定のオブジェクトの URI を取得します。

参照

関連項目

IMethodMessage インターフェイス
System.Runtime.Remoting.Messaging 名前空間

IMethodMessage メソッド

パブリック メソッド

	名前	説明
	GetArg	指定した引数を Object 型として取得します。
	GetArgName	メソッドに渡された引数の名前を取得します。

参照

関連項目

IMethodMessage インターフェイス
System.Runtime.Remoting.Messaging 名前空間

IMethodMessage メンバ

メソッド メッセージのインターフェイスを定義します。

IMethodMessage データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	ArgCount	メソッドに渡された引数の数を取得します。
	Args	メソッドに渡された引数の配列を取得します。
	HasVarArgs	メッセージに可変個の引数があるかどうかを示す値を取得します。
	LogicalCallContext	現在のメソッド呼び出しの LogicalCallContext を取得します。
	MethodBase	呼び出されたメソッドの MethodBase を取得します。
	MethodName	呼び出されたメソッドの名前を取得します。
	MethodSignature	メソッド シグネチャを格納しているオブジェクトを取得します。
	TypeName	呼び出しの送信先となる特定のオブジェクトの完全な Type 名を取得します。
	Uri	呼び出しの送信先となる特定のオブジェクトの URI を取得します。

パブリック メソッド

	名前	説明
	GetArg	指定した引数を Object 型として取得します。
	GetArgName	メソッドに渡された引数の名前を取得します。

参照

関連項目

IMethodMessage インターフェイス
System.Runtime.Remoting.Messaging 名前空間