ReturnMessage

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

ReturnMessage クラス

リモート オブジェクトに対するメソッド呼び出しへの応答として返されるメッセージを保持します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class ReturnMessage
    Implements IMethodReturnMessage, IMethodMessage, IMessage

Visual Basic (使用法)

Dim instance As ReturnMessage

C#

[ComVisibleAttribute(true)] 
public class ReturnMessage : IMethodReturnMessage,
 IMethodMessage, IMessage

C++

[ComVisibleAttribute(true)] 
public ref class ReturnMessage : IMethodReturnMessage,
 IMethodMessage, IMessage

J#

/** @attribute ComVisibleAttribute(true) */ 
public class ReturnMessage implements IMethodReturnMessage,
 IMethodMessage, 
    IMessage

JScript

ComVisibleAttribute(true) 
public class ReturnMessage implements IMethodReturnMessage,
 IMethodMessage, 
    IMessage

解説

メモ
このクラスは、リンク確認要求と継承確認要求をクラス レベルで行います。直前の呼び出し元または派生クラスにインフラストラクチャ アクセス許可がない場合、SecurityException がスローされます。セキュリティ要求の詳細については、「リンク確認要求」および「継承確認要求」を参照してください。

使用例

Visual Basic

<PermissionSet(SecurityAction.Demand, Name:="FullTrust")>
 _
Public Class MyProxy
   Inherits RealProxy
   Private stringUri As String
   Private myMarshalByRefObject As MarshalByRefObject
   
   Public Sub New(myType
 As Type)
      MyBase.New(myType)
      myMarshalByRefObject = CType(Activator.CreateInstance(myType), MarshalByRefObject)
      Dim myObject As ObjRef = RemotingServices.Marshal(myMarshalByRefObject)
      stringUri = myObject.URI
   End Sub 'New
   
   Public Overrides Function
 Invoke(myMessage As IMessage) As IMessage
      Dim myCallMessage As IMethodCallMessage
 = CType(myMessage, IMethodCallMessage)

      Dim myIMethodReturnMessage As IMethodReturnMessage
 = RemotingServices. _
         ExecuteMessage(myMarshalByRefObject, myCallMessage)

      Console.WriteLine("Method name : " + myIMethodReturnMessage.MethodName)
      Console.WriteLine("The return value is : " +
 myIMethodReturnMessage.ReturnValue)
      
      ' Get number of 'ref' and 'out' parameters.
      Dim myArgOutCount As Integer
 = myIMethodReturnMessage.OutArgCount
      Console.WriteLine("The number of 'ref',
 'out' parameters are : " + _
         myIMethodReturnMessage.OutArgCount.ToString())
      ' Gets name and values of 'ref' and 'out' parameters.
      Dim i As Integer
      For i = 0 To myArgOutCount - 1
         Console.WriteLine("Name of argument {0} is
 '{1}'.", i, _
            myIMethodReturnMessage.GetOutArgName(i))
         Console.WriteLine("Value of argument {0} is
 '{1}'.", i, _
            myIMethodReturnMessage.GetOutArg(i))
      Next i
      Console.WriteLine()
      Dim myObjectArray As Object()
 = myIMethodReturnMessage.OutArgs
      For i = 0 To myObjectArray.Length - 1
         Console.WriteLine("Value of argument {0} is
 '{1}' in OutArgs", i, myObjectArray(i))
      Next i
      Return myIMethodReturnMessage
   End Function 'Invoke
End Class 'MyProxy

C#

[PermissionSet(SecurityAction.Demand, Name="FullTrust")]
public class MyProxy : RealProxy
{
   String stringUri;
   MarshalByRefObject myMarshalByRefObject;

   public MyProxy(Type myType): base(myType)
   {
      myMarshalByRefObject = (MarshalByRefObject)Activator.CreateInstance(myType);
      ObjRef myObject = RemotingServices.Marshal(myMarshalByRefObject);
      stringUri = myObject.URI;
   }

   public override IMessage Invoke(IMessage myMessage)
   {
      IMethodCallMessage myCallMessage = (IMethodCallMessage)myMessage;

      IMethodReturnMessage myIMethodReturnMessage =
         RemotingServices.ExecuteMessage(myMarshalByRefObject, myCallMessage);

      Console.WriteLine("Method name : " + myIMethodReturnMessage.MethodName);
      Console.WriteLine("The return value is : " + myIMethodReturnMessage.ReturnValue);

      // Get number of 'ref' and 'out' parameters.
      int myArgOutCount = myIMethodReturnMessage.OutArgCount;
      Console.WriteLine("The number of 'ref', 'out' parameters are : "
 +
         myIMethodReturnMessage.OutArgCount);
      // Gets name and values of 'ref' and 'out' parameters.
      for(int i = 0; i < myArgOutCount;
 i++)
      {
         Console.WriteLine("Name of argument {0} is '{1}'.",
            i, myIMethodReturnMessage.GetOutArgName(i));
         Console.WriteLine("Value of argument {0} is '{1}'.",
            i, myIMethodReturnMessage.GetOutArg(i));
      }
      Console.WriteLine();
      object[] myObjectArray = myIMethodReturnMessage.OutArgs; 
      for(int i = 0; i < myObjectArray.Length;
 i++)
         Console.WriteLine("Value of argument {0} is '{1}' in
 OutArgs",
            i, myObjectArray[i]);
      return myIMethodReturnMessage;
   }
}

C++

[System::Security::Permissions::SecurityPermissionAttribute
(System::Security::Permissions::SecurityAction::LinkDemand, 
Flags=System::Security::Permissions::SecurityPermissionFlag::Infrastructure)]
[System::Security::Permissions::SecurityPermissionAttribute
(System::Security::Permissions::SecurityAction::InheritanceDemand, 
Flags=System::Security::Permissions::SecurityPermissionFlag::Infrastructure)]
public ref class MyProxy: public
 RealProxy
{
private:
   String^ stringUri;
   MarshalByRefObject^ myMarshalByRefObject;

public:
   MyProxy( Type^ myType ) : RealProxy( myType )
   {
      myMarshalByRefObject = dynamic_cast<MarshalByRefObject^>(Activator::CreateInstance(
 myType ));
      ObjRef^ myObject = RemotingServices::Marshal( myMarshalByRefObject );
      stringUri = myObject->URI;
   }

   virtual IMessage^ Invoke( IMessage^ myMessage ) override
   {
      IMethodCallMessage^ myCallMessage = (IMethodCallMessage^)( myMessage );

      IMethodReturnMessage^ myIMethodReturnMessage =
         RemotingServices::ExecuteMessage( myMarshalByRefObject, myCallMessage );

      Console::WriteLine( "Method name : {0}", myIMethodReturnMessage->MethodName
 );
      Console::WriteLine( "The return value is : {0}",
 myIMethodReturnMessage->ReturnValue );

      // Get number of 'ref' and 'out' parameters.
      int myArgOutCount = myIMethodReturnMessage->OutArgCount;
      Console::WriteLine( "The number of 'ref', 'out' parameters are : {0}"
,
         myIMethodReturnMessage->OutArgCount );
      // Gets name and values of 'ref' and 'out' parameters.
      for ( int i = 0; i < myArgOutCount;
 i++ )
      {
         Console::WriteLine( "Name of argument {0} is '{1}'.",
            i, myIMethodReturnMessage->GetOutArgName( i ) );
         Console::WriteLine( "Value of argument {0} is '{1}'.",
            i, myIMethodReturnMessage->GetOutArg( i ) );
      }
      Console::WriteLine();
      array<Object^>^myObjectArray = myIMethodReturnMessage->OutArgs;
      for ( int i = 0; i < myObjectArray->Length;
 i++ )
         Console::WriteLine( "Value of argument {0} is '{1}' in
 OutArgs",
            i, myObjectArray[ i ] );
      return myIMethodReturnMessage;
   }
};

J#

/** @attribute SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.Infrastructure)
*/
public class MyProxy extends RealProxy
{
    private String stringUri;
    private MarshalByRefObject myMarshalByRefObject;

    public MyProxy(Type myType)
    {
        super(myType);
        myMarshalByRefObject 
            = (MarshalByRefObject)Activator.CreateInstance(myType);
        ObjRef myObject = RemotingServices.Marshal(myMarshalByRefObject);
        stringUri = myObject.get_URI();
    } //MyProxy

    public IMessage Invoke(IMessage myMessage)
    {
        IMethodCallMessage myCallMessage = (IMethodCallMessage)myMessage;
        IMethodReturnMessage myIMethodReturnMessage 
            = RemotingServices.ExecuteMessage(myMarshalByRefObject,
                myCallMessage);
        Console.WriteLine("Method name : " 
            + myIMethodReturnMessage.get_MethodName());
        Console.WriteLine("The return value is : " 
            + myIMethodReturnMessage.get_ReturnValue());

        // Get number of 'ref' and 'out' parameters.
        int myArgOutCount = myIMethodReturnMessage.get_OutArgCount();

        Console.WriteLine("The number of 'ref', 'out' parameters are : "
 
            + myIMethodReturnMessage.get_OutArgCount());

        // Gets name and values of 'ref' and 'out' parameters.
        for (int i = 0; i < myArgOutCount;
 i++) {
            Console.WriteLine("Name of argument {0} is '{1}'.",
                System.Convert.ToString(i),
                myIMethodReturnMessage.GetOutArgName(i));
            Console.WriteLine("Value of argument {0} is '{1}'.",
                System.Convert.ToString(i),
                myIMethodReturnMessage.GetOutArg(i));
        }
        Console.WriteLine();
        Object myObjectArray[] = myIMethodReturnMessage.get_OutArgs();

        for (int i = 0; i < myObjectArray.length;
 i++) {
            Console.WriteLine("Value of argument {0} is '{1}' in
 OutArgs",
                System.Convert.ToString(i), myObjectArray.get_Item(i));
        }

        return myIMethodReturnMessage;
    } //Invoke
} //MyProxy

.NET Framework のセキュリティ

• SecurityPermission  (インフラストラクチャ コードを操作するために必要なアクセス許可)。要求値 : SecurityAction.LinkDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure
• SecurityPermission  (インフラストラクチャ コードを操作するために必要なアクセス許可)。要求値 : SecurityAction.InheritanceDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure

継承階層

System.Object
  System.Runtime.Remoting.Messaging.ReturnMessage

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

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

ReturnMessage コンストラクタ (Object, Object[], Int32, LogicalCallContext, IMethodCallMessage)

メソッドの呼び出し後に呼び出し元に返されるすべての情報を指定して、ReturnMessage クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    ret As Object, _
    outArgs As Object(), _
    outArgsCount As Integer, _
    callCtx As LogicalCallContext, _
    mcm As IMethodCallMessage _
)

Visual Basic (使用法)

Dim ret As Object
Dim outArgs As Object()
Dim outArgsCount As Integer
Dim callCtx As LogicalCallContext
Dim mcm As IMethodCallMessage

Dim instance As New ReturnMessage(ret,
 outArgs, outArgsCount, callCtx, mcm)

C#

public ReturnMessage (
    Object ret,
    Object[] outArgs,
    int outArgsCount,
    LogicalCallContext callCtx,
    IMethodCallMessage mcm
)

C++

public:
ReturnMessage (
    Object^ ret, 
    array<Object^>^ outArgs, 
    int outArgsCount, 
    LogicalCallContext^ callCtx, 
    IMethodCallMessage^ mcm
)

J#

public ReturnMessage (
    Object ret, 
    Object[] outArgs, 
    int outArgsCount, 
    LogicalCallContext callCtx, 
    IMethodCallMessage mcm
)

JScript

public function ReturnMessage (
    ret : Object, 
    outArgs : Object[], 
    outArgsCount : int, 
    callCtx : LogicalCallContext, 
    mcm : IMethodCallMessage
)

パラメータ

ret

呼び出されたメソッドから、現在の ReturnMessage インスタンスの生成元として返されるオブジェクト。

outArgs

呼び出されたメソッドから out パラメータとして返されるオブジェクト。

outArgsCount

呼び出されたメソッドから返される out パラメータの数。

callCtx

メソッド呼び出しの LogicalCallContext。

mcm

呼び出されたメソッドに対する元のメソッド呼び出し。

プラットフォーム

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

参照

関連項目
ReturnMessage クラス
ReturnMessage メンバ
System.Runtime.Remoting.Messaging 名前空間

ReturnMessage コンストラクタ (Exception, IMethodCallMessage)

ReturnMessage クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    e As Exception, _
    mcm As IMethodCallMessage _
)

Visual Basic (使用法)

Dim e As Exception
Dim mcm As IMethodCallMessage

Dim instance As New ReturnMessage(e,
 mcm)

C#

public ReturnMessage (
    Exception e,
    IMethodCallMessage mcm
)

C++

public:
ReturnMessage (
    Exception^ e, 
    IMethodCallMessage^ mcm
)

J#

public ReturnMessage (
    Exception e, 
    IMethodCallMessage mcm
)

JScript

public function ReturnMessage (
    e : Exception, 
    mcm : IMethodCallMessage
)

パラメータ

e

リモートで呼び出されたメソッドの実行中にスローされた例外。

mcm

ReturnMessage クラスのインスタンスを作成するために使用する IMethodCallMessage。

プラットフォーム

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

参照

関連項目
ReturnMessage クラス
ReturnMessage メンバ
System.Runtime.Remoting.Messaging 名前空間

ReturnMessage コンストラクタ

ReturnMessage クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ReturnMessage (Exception, IMethodCallMessage)	ReturnMessage クラスの新しいインスタンスを初期化します。
ReturnMessage (Object, Object[], Int32, LogicalCallContext, IMethodCallMessage)	メソッドの呼び出し後に呼び出し元に返されるすべての情報を指定して、ReturnMessage クラスの新しいインスタンスを初期化します。

参照

関連項目

ReturnMessage クラス
ReturnMessage メンバ
System.Runtime.Remoting.Messaging 名前空間

ReturnMessage プロパティ

パブリック プロパティ

	名前	説明
	ArgCount	呼び出されたメソッドの引数の数を取得します。
	Args	リモート オブジェクトに対して呼び出されたメソッドに渡された、指定された引数を取得します。
	Exception	リモートのメソッド呼び出し時にスローされた例外を取得します。
	HasVarArgs	呼び出されたメソッドが可変個の引数を受け入れるかどうかを示す値を取得します。
	LogicalCallContext	呼び出されたメソッドの LogicalCallContext を取得します。
	MethodBase	呼び出されたメソッドの MethodBase を取得します。
	MethodName	呼び出されたメソッドの名前を取得します。
	MethodSignature	メソッド シグネチャを格納している Type オブジェクトの配列を取得します。
	OutArgCount	呼び出されたメソッドの out 引数または ref 引数の数を取得します。
	OutArgs	呼び出されたメソッドに out パラメータまたは ref パラメータとして渡された、指定されたオブジェクトを取得します。
	Properties	現在の ReturnMessage に格納されているプロパティの IDictionary を取得します。
	ReturnValue	呼び出されたメソッドが返したオブジェクトを取得します。
	TypeName	リモート メソッドが呼び出された対象の型の名前を取得します。
	Uri	リモート メソッドが呼び出された対象のリモート オブジェクトの URI を取得または設定します。

参照

関連項目

ReturnMessage クラス
System.Runtime.Remoting.Messaging 名前空間

ReturnMessage メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetArg	メソッドの呼び出し時にリモート メソッドに渡された、指定された引数を返します。
	GetArgName	指定されたメソッド引数の名前を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetOutArg	リモートのメソッド呼び出し時に out パラメータまたは ref パラメータとして渡されたオブジェクトを返します。
	GetOutArgName	リモート メソッドに渡された、指定された out パラメータまたは ref パラメータの名前を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

ReturnMessage クラス
System.Runtime.Remoting.Messaging 名前空間

ReturnMessage メンバ

リモート オブジェクトに対するメソッド呼び出しへの応答として返されるメッセージを保持します。

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

パブリック コンストラクタ

	名前	説明
	ReturnMessage	オーバーロードされます。 ReturnMessage クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ArgCount	呼び出されたメソッドの引数の数を取得します。
	Args	リモート オブジェクトに対して呼び出されたメソッドに渡された、指定された引数を取得します。
	Exception	リモートのメソッド呼び出し時にスローされた例外を取得します。
	HasVarArgs	呼び出されたメソッドが可変個の引数を受け入れるかどうかを示す値を取得します。
	LogicalCallContext	呼び出されたメソッドの LogicalCallContext を取得します。
	MethodBase	呼び出されたメソッドの MethodBase を取得します。
	MethodName	呼び出されたメソッドの名前を取得します。
	MethodSignature	メソッド シグネチャを格納している Type オブジェクトの配列を取得します。
	OutArgCount	呼び出されたメソッドの out 引数または ref 引数の数を取得します。
	OutArgs	呼び出されたメソッドに out パラメータまたは ref パラメータとして渡された、指定されたオブジェクトを取得します。
	Properties	現在の ReturnMessage に格納されているプロパティの IDictionary を取得します。
	ReturnValue	呼び出されたメソッドが返したオブジェクトを取得します。
	TypeName	リモート メソッドが呼び出された対象の型の名前を取得します。
	Uri	リモート メソッドが呼び出された対象のリモート オブジェクトの URI を取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetArg	メソッドの呼び出し時にリモート メソッドに渡された、指定された引数を返します。
	GetArgName	指定されたメソッド引数の名前を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetOutArg	リモートのメソッド呼び出し時に out パラメータまたは ref パラメータとして渡されたオブジェクトを返します。
	GetOutArgName	リモート メソッドに渡された、指定された out パラメータまたは ref パラメータの名前を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

ReturnMessage クラス
System.Runtime.Remoting.Messaging 名前空間