IObjectReference.GetRealObject(StreamingContext) Méthode

Définition

Espace de noms:

System.Runtime.Serialization

Assembly:

System.Runtime.dll

Retourne l'objet réel qui doit être désérialisé, plutôt que l'objet spécifié par le flux sérialisé.

public:
 System::Object ^ GetRealObject(System::Runtime::Serialization::StreamingContext context);

public object GetRealObject (System.Runtime.Serialization.StreamingContext context);

abstract member GetRealObject : System.Runtime.Serialization.StreamingContext -> obj

Public Function GetRealObject (context As StreamingContext) As Object

Paramètres

context

StreamingContext

StreamingContext à partir duquel l'objet en cours est désérialisé.

Retours

Object

Objet réel placé dans le graphique.

Exceptions

SecurityException

L'appelant n'a pas l'autorisation requise. L'appel ne fonctionnera pas sur un serveur de confiance moyenne.

Remarques

Cette méthode est utile dans une situation de communication à distance où vous sérialisez un objet proxy-créateur, et non un objet réel. Lorsque l’objet proxy-creator est désérialisé, la désérialisation appelle sa GetRealObject méthode. À ce stade, l’objet proxy-creator crée une nouvelle instance de l’objet proxy qui fait référence à l’objet réel d’origine, peut-être sur un ordinateur distant. Enfin, l’objet proxy-creator est ignoré et récupéré ultérieurement par le garbage collection.

Par exemple, considérez comment Type les objets sont sérialisés. Au lieu de transmettre les données à partir de l’objet Type , le système transmet un objet holder avec le nom de l’objet de type et des informations sur l’assembly où il se trouve dans un objet implémentant IObjectReference. Lorsque le nom de type et le nom de l’assembly sont disponibles, l’infrastructure de désérialisation appelle GetRealObject sur l’objet titulaire qui a été transmis. Ce titulaire retourne l’objet Type qui est inséré dans le graphique.