Partager via


CachedException - Classe

Utilisée par un cache pour signaler un problème avec une cause d'origine qui a pu se produire dans le passé dans le cadre d'une opération distincte.

Hiérarchie d’héritage

System.Object
  System.Exception
    Microsoft.SharePoint.Publishing.CachedException

Espace de noms :  Microsoft.SharePoint.Publishing
Assembly :  Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)

Syntaxe

'Déclaration
<SerializableAttribute> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
Public NotInheritable Class CachedException _
    Inherits Exception
'Utilisation
Dim instance As CachedException
[SerializableAttribute]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
public sealed class CachedException : Exception

Remarques

Pour certaines stratégies de mise en cache, il est avantageux pour mettre en cache les requêtes correctement exécutées et les demandes qui ont échoué en raison d'une exception. L'exception d'origine est stockée dans le cache et levée à nouveau lors des demandes suivantes sont effectuées pour le même objet. Réutilisation de l'objet exception d'origine présente quelques inconvénients : par exemple, la propriété StackTrace est remplacée, l'appelant peut tenter de gérer les deux fois le même problème et qu'il n'y a aucun moyen d'effectuer le suivi du contexte où s'est produite l'erreur d'origine.

La classe CachedException résout ces problèmes en encapsulant l'objet partagé en tant que sa propriété InnerException et le suivi des détails supplémentaires tels que l'ID de timestamp et corrélation pour la requête HTTP d'origine.

Par exemple, si le système de navigation de taxonomie rencontre une erreur lorsqu'il essaie de lire un objet TermSet dans le cache de navigation de classification, les tentatives d'extraction de l'objet lever des instances de CachedException au lieu de retenter l'opération.

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

CachedException - Membres

Microsoft.SharePoint.Publishing - Espace de noms

Microsoft.SharePoint.Publishing.Navigation.TaxonomyNavigation