IMethodReturnMessage Interfaccia

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.Remoting.Messaging

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce l'interfaccia del messaggio restituito della chiamata di metodo.

public interface class IMethodReturnMessage : System::Runtime::Remoting::Messaging::IMethodMessage

public interface IMethodReturnMessage : System.Runtime.Remoting.Messaging.IMethodMessage

[System.Runtime.InteropServices.ComVisible(true)]
public interface IMethodReturnMessage : System.Runtime.Remoting.Messaging.IMethodMessage

type IMethodReturnMessage = interface
    interface IMethodMessage
    interface IMessage

[<System.Runtime.InteropServices.ComVisible(true)>]
type IMethodReturnMessage = interface
    interface IMethodMessage
    interface IMessage

Public Interface IMethodReturnMessage
Implements IMethodMessage

Derivato: System.Runtime.Remoting.Activation.IConstructionReturnMessage

System.Runtime.Remoting.Messaging.ConstructionResponse

System.Runtime.Remoting.Messaging.MethodResponse

System.Runtime.Remoting.Messaging.MethodReturnMessageWrapper

System.Runtime.Remoting.Messaging.ReturnMessage

Attributi: ComVisibleAttribute

Implementazioni: IMessage IMethodMessage

Esempio

Il codice di esempio seguente mostra un proxy personalizzato che esegue l'override RealProxy.Invoke per scrivere le informazioni sul messaggio restituite nella console.

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

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

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

Commenti

Un messaggio restituito della chiamata al metodo rappresenta la risposta a una chiamata al metodo su un oggetto alla fine del sink del messaggio. Un IMethodReturnMessage oggetto viene generato come risultato di un metodo chiamato su un oggetto remoto e viene usato per restituire i risultati della chiamata al chiamante.

Proprietà

ArgCount	Ottiene il numero di argomenti passati al metodo. (Ereditato da IMethodMessage)
Args	Ottiene una matrice di argomenti passati al metodo. (Ereditato da IMethodMessage)
Exception	Ottiene l'eccezione generata durante la chiamata di metodo.
HasVarArgs	Ottiene un valore che indica se il messaggio contiene argomenti variabili. (Ereditato da IMethodMessage)
LogicalCallContext	Ottiene l'oggetto LogicalCallContext per la chiamata di metodo corrente. (Ereditato da IMethodMessage)
MethodBase	Ottiene l'oggetto MethodBase del metodo chiamato. (Ereditato da IMethodMessage)
MethodName	Ottiene il nome del metodo richiamato. (Ereditato da IMethodMessage)
MethodSignature	Ottiene un oggetto contenente la firma del metodo. (Ereditato da IMethodMessage)
OutArgCount	Ottiene il numero di argomenti nella chiamata di metodo contrassegnati come parametri `ref` o `out`.
OutArgs	Restituisce l'argomento specificato contrassegnato come parametro `ref` o `out`.
Properties	Ottiene un IDictionary che rappresenta un insieme di proprietà del messaggio. (Ereditato da IMessage)
ReturnValue	Ottiene il valore restituito dalla chiamata di metodo.
TypeName	Ottiene il nome Type completo dell'oggetto specifico a cui è destinata la chiamata. (Ereditato da IMethodMessage)
Uri	Ottiene l'URI dell'oggetto specifico a cui è destinata la chiamata. (Ereditato da IMethodMessage)

Metodi

GetArg(Int32)	Ottiene un argomento specifico come Object. (Ereditato da IMethodMessage)
GetArgName(Int32)	Ottiene il nome dell'argomento passato al metodo. (Ereditato da IMethodMessage)
GetOutArg(Int32)	Restituisce l'argomento specificato contrassegnato come parametro `ref` o `out`.
GetOutArgName(Int32)	Restituisce il nome dell'argomento specificato contrassegnato come parametro `ref` o `out`.

Si applica a