Vue d'ensemble de la gestion des exceptions (mise en cache de Windows Server AppFabric)

  • Article

L'API de mise en cache de Windows Server AppFabric génère des exceptions .NET quand une erreur se produit. Cette rubrique présente les concepts de base de gestion des erreurs et fournit un exemple.

Classe DataCacheException

Un objet DataCacheException commun est généré pour les erreurs spécifiques des méthodes de mise en cache d'AppFabric. L'objet DataCacheException contient quatre propriétés qui peuvent vous aider à diagnostiquer la cause de l'exception :

Propriété DataCacheException Description

Message

Chaîne décrivant l'erreur.

ErrorCode

Nombre entier correspondant à une constante de code d'erreur dans la classe DataCacheErrorCode.

SubStatus

Nombre entier correspondant à une constante de sous-état dans la classe DataCacheErrorSubStatus.

InnerException

Instance d'exception causée par l'exception actuelle. Cette valeur peut être définie sur Null.

Certains échecs, par exemple d'expiration de délai, peuvent résulter de n'importe quelle méthode de client de cache. Le code de votre application doit être préparé à gérer ces exceptions communes. Pour plus d'informations, consultez la rubrique Exceptions courantes (mise en cache de Windows Server AppFabric).

Notes

Certains échecs ne génèrent pas d'exception. Par exemple, la méthode Get renvoie la valeur Null si la clé est introuvable. D'autres méthodes peuvent renvoyer des valeurs booléennes pour indiquer une réussite ou un échec. Pour plus d'informations sur des méthodes spécifiques, consultez l'espace de noms Microsoft.ApplicationServer.Caching dans la documentation sur la bibliothèque de classes de Windows Server AppFabric.

Exemple

L'exemple suivant tente de placer (opération put) un objet string nommé strObject dans un DataCache nommé myCache. La méthode surchargée Put permet de spécifier une zone de cache pour l'objet. Si celle-ci n'existe pas encore dans le cache, un objet DataCacheException est généré avec un code d'erreur RegionDoesNotExist. Dans cet exemple, cette erreur est gérée en créant la région, puis en réessayant d'exécuter l'opération put.

Dim strKey As String = "key0"
Dim strObject As String = "Source String"

Try
   ' Put a string object into the cache region, "Region1"
   myCache.Put(strKey, strObject, "Region1")

Catch cacheError As DataCacheException
   ' Look at the ErrorCode property to see if the Region is missing
   If (cacheError.ErrorCode = DataCacheErrorCode.RegionDoesNotExist) Then

      ' Create the Region and retry the Put call
      myCache.CreateRegion("Region1")
      myCache.Put(strKey, strObject, "Region1")
   End If
End Try

string strKey = "key0";
string strObject = "Source String";

try
{
   // Put a string object into the cache region, "Region1"
   myCache.Put(strKey, strObject, "Region1");
}
catch (DataCacheException cacheError)
{
   // Look at the ErrorCode property to see if the Region is missing
   if (cacheError.ErrorCode == DataCacheErrorCode.RegionDoesNotExist)
   {
      // Create the Region and retry the Put call
      myCache.CreateRegion("Region1");
      myCache.Put(strKey, strObject, "Region1");
   }
}

Voir aussi

Concepts

Exceptions courantes (mise en cache de Windows Server AppFabric)
Configuration des délais d'expiration du client de cache (mise en cache de Windows Server AppFabric)

  2011-12-05