Exception.SerializeObjectState Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsqu’une exception est sérialisée pour créer un objet d’état d’exception qui contient des données sérialisées sur l’exception.
protected:
event EventHandler<System::Runtime::Serialization::SafeSerializationEventArgs ^> ^ SerializeObjectState;protected event EventHandler<System.Runtime.Serialization.SafeSerializationEventArgs> SerializeObjectState;member this.SerializeObjectState : EventHandler<System.Runtime.Serialization.SafeSerializationEventArgs> Protected Custom Event SerializeObjectState As EventHandler(Of SafeSerializationEventArgs) Type d'événement
Remarques
L’objet d’état d’exception implémente l’interface ISafeSerializationData .
Lorsque l’événement SerializeObjectState est abonné, l’exception est désérialisée et créée en tant qu’exception vide. Le constructeur de l’exception n’est pas exécuté et l’état de l’exception est également désérialisé. La CompleteDeserialization méthode de rappel de l’objet d’état d’exception est ensuite avertie afin qu’elle puisse envoyer (push) des données désérialisées dans l’exception vide.
L’événement SerializeObjectState permet aux types d’exceptions transparents de sérialiser et de désérialiser les données d’exception. Le code transparent peut exécuter des commandes dans les limites du jeu d’autorisations dans lequel il fonctionne, mais ne peut pas exécuter, appeler, dériver ou contenir du code critique.
Si l’événement n’est pas abonné, la SerializeObjectState désérialisation se produit comme d’habitude à l’aide du Exception constructeur.
En règle générale, un gestionnaire pour l’événement SerializeObjectState est ajouté dans le constructeur de l’exception pour fournir sa sérialisation. Toutefois, étant donné que le constructeur n’est pas exécuté lorsque le gestionnaire d’événements s’exécute, la SerializeObjectState sérialisation d’une exception désérialisée peut lever une SerializationException exception lorsque vous essayez de désérialiser l’exception. Pour éviter cela, vous devez également ajouter le gestionnaire pour l’événement SerializeObjectState dans la ISafeSerializationData.CompleteDeserialization méthode. Consultez la section Exemples pour obtenir une illustration.
Notes pour les héritiers
Si cet événement est abonné et utilisé, tous les types dérivés qui suivent dans la hiérarchie d’héritage doivent implémenter le même mécanisme de sérialisation.