RemotingServices.Unmarshal Méthode

public:
 static System::Object ^ Unmarshal(System::Runtime::Remoting::ObjRef ^ objectRef);

public static object Unmarshal(System.Runtime.Remoting.ObjRef objectRef);

[System.Security.SecurityCritical]
public static object Unmarshal(System.Runtime.Remoting.ObjRef objectRef);

static member Unmarshal : System.Runtime.Remoting.ObjRef -> obj

[<System.Security.SecurityCritical>]
static member Unmarshal : System.Runtime.Remoting.ObjRef -> obj

Public Shared Function Unmarshal (objectRef As ObjRef) As Object

Paramètres

Retours

Proxy vers l’objet que représente l’objet donné ObjRef .

Attributs

SecurityCriticalAttribute

Exceptions

Exemples

L’exemple de code suivant montre comment disshaler un objet.

ChannelServices::RegisterChannel( gcnew HttpChannel );

SampleService ^ objectSample = (SampleService^)( Activator::GetObject( SampleService::typeid,
   "http://localhost:9000/MySampleService/SampleService.soap" ) );

// The GetManuallyMarshaledObject() method uses RemotingServices::Marshal()
// to create an ObjRef object for a SampleTwo object.
ObjRef^ objRefSampleTwo = objectSample->GetManuallyMarshaledObject();

SampleTwo ^ objectSampleTwo = (SampleTwo^)( RemotingServices::Unmarshal( objRefSampleTwo ) );

objectSampleTwo->PrintMessage( "ObjRef successfuly unmarshaled." );

ChannelServices.RegisterChannel(new HttpChannel());

SampleService objectSample = (SampleService)Activator.GetObject(typeof(SampleService),
    "http://localhost:9000/MySampleService/SampleService.soap");

// The GetManuallyMarshaledObject() method uses RemotingServices.Marshal()
// to create an ObjRef object for a SampleTwo object.
ObjRef objRefSampleTwo = objectSample.GetManuallyMarshaledObject();

SampleTwo objectSampleTwo = (SampleTwo)RemotingServices.Unmarshal(objRefSampleTwo);

objectSampleTwo.PrintMessage("ObjRef successfuly unmarshaled.");

ChannelServices.RegisterChannel(New HttpChannel())

Dim objectSample As SampleService = CType(Activator.GetObject(GetType(SampleService), _ 
      "http://localhost:9000/MySampleService/SampleService.soap"), SampleService)

' The GetManuallyMarshaledObject() method uses RemotingServices.Marshal()
' to create an ObjRef object for a SampleTwo object.
Dim objRefSampleTwo As ObjRef = objectSample.GetManuallyMarshaledObject()

Dim objectSampleTwo As SampleTwo = CType(RemotingServices.Unmarshal(objRefSampleTwo), SampleTwo)

objectSampleTwo.PrintMessage("I successfully unmarshaled your ObjRef.  Thanks.")

Remarques

Il ObjRef s’agit d’une représentation sérialisable d’un objet utilisé pour transférer une référence d’objet sur une limite de domaine d’application. La création d’un ObjRef objet est appelée marshaling. Il ObjRef peut être transféré via un canal vers un autre domaine d’application (éventuellement sur un autre processus ou ordinateur). Une fois dans l’autre domaine d’application, il ObjRef doit être analysé pour créer un proxy pour l’objet, généralement connecté à l’objet réel. Cette opération est appelée démarshalation. Lors de l’annulation de l’analyse, il ObjRef est analysé pour extraire les informations de méthode de l’objet distant et le proxy transparent et RealProxy les objets sont créés. Le contenu de l’analyse ObjRef est ajouté au proxy transparent avant l’inscription du proxy transparent auprès du Common Language Runtime.

Contient ObjRef des informations qui décrivent la classe et la classe de l’objet en cours de marshalé, un URI qui identifie de manière unique l’instance d’objet spécifique et des informations relatives aux communications relatives à la Type façon d’atteindre la sous-division de communication à distance où se trouve l’objet.

Voir aussi

• RealProxy
• ObjRef

public:
 static System::Object ^ Unmarshal(System::Runtime::Remoting::ObjRef ^ objectRef, bool fRefine);

public static object Unmarshal(System.Runtime.Remoting.ObjRef objectRef, bool fRefine);

[System.Security.SecurityCritical]
public static object Unmarshal(System.Runtime.Remoting.ObjRef objectRef, bool fRefine);

static member Unmarshal : System.Runtime.Remoting.ObjRef * bool -> obj

[<System.Security.SecurityCritical>]
static member Unmarshal : System.Runtime.Remoting.ObjRef * bool -> obj

Public Shared Function Unmarshal (objectRef As ObjRef, fRefine As Boolean) As Object

Paramètres

Retours

Proxy vers l’objet que représente l’objet donné ObjRef .

Attributs

SecurityCriticalAttribute

Exceptions

Remarques

Il ObjRef s’agit d’une représentation sérialisable d’un objet utilisé pour transférer une référence d’objet sur une limite de domaine d’application. La création d’un ObjRef objet est appelée marshaling. Il ObjRef peut être transféré via un canal vers un autre domaine d’application (éventuellement sur un autre processus ou ordinateur). Une fois dans l’autre domaine d’application, il ObjRef doit être analysé pour créer un proxy pour l’objet, généralement connecté à l’objet réel. Cette opération est appelée démarshalation. Lors de l’annulation de l’analyse, il ObjRef est analysé pour extraire les informations de méthode de l’objet distant et le proxy transparent et RealProxy les objets sont créés. Le contenu de l’analyse ObjRef est ajouté au proxy transparent avant l’inscription du proxy transparent auprès du Common Language Runtime.

Contient ObjRef des informations qui décrivent la classe et la classe de l’objet en cours de marshalé, un URI qui identifie de manière unique l’instance d’objet spécifique et des informations relatives aux communications relatives à la Type façon d’atteindre la sous-division de communication à distance où se trouve l’objet.

Lors de la première création, le proxy est de type MarshalByRefObject. Lorsque vous le convertissez en différents types, l’infrastructure de communication à distance effectue le suivi du type le plus utilisé pour éviter de charger inutilement le type.

Voir aussi

• RealProxy
• ObjRef