Základní informace o zpracování výjimek (ukládání do mezipaměti technologie Windows Server AppFabric)

Rozhraní API technologie Windows Server AppFabric pro ukládání do mezipaměti vrátí v případě výskytu chyb výjimky platformy .NET. V tomto tématu jsou vysvětleny základní koncepty zpracování chyb a je zde uveden příklad.

Třída DataCacheException

V případě chyb specifických pro metody ukládání do mezipaměti technologie AppFabric je vrácen obecný objekt DataCacheException. Objekt DataCacheException obsahuje čtyři vlastnosti, které mohou pomoci při diagnostice příčiny výjimky:

Vlastnost objektu DataCacheException	Popis
Message	Řetězec popisující chybu
ErrorCode	Celočíselná hodnota odpovídající konstantě kódu chyby ve třídě DataCacheErrorCode
SubStatus	Celočíselná hodnota odpovídající konstantě podřízeného stavu ve třídě DataCacheErrorSubStatus
InnerException	Instance výjimky, která způsobila aktuální výjimku. Tato vlastnost může mít hodnotu null.

K některým chybám, jako je například vypršení časového limitu, může dojít z libovolné metody klienta mezipaměti. Kód aplikace by měl být připraven na zpracování těchto obecných výjimek. Další informace naleznete v tématu Obecné výjimky (ukládání do mezipaměti technologie Windows Server AppFabric).

Poznámka

Některé chyby nevrátí výjimku. Například metoda Get vrátí v případě, že není nalezen klíč, hodnotu null. Jiné metody mohou vrátit logické hodnoty informující o úspěchu či selhání. Další informace o konkrétních metodách naleznete v oboru názvů Microsoft.ApplicationServer.Caching v dokumentaci ke knihovně tříd technologie Windows Server AppFabric.

Příklad

Následující příklad se pokusí umístit objekt řetězce s názvem strObject do mezipaměti DataCache s názvem myCache. Přetížená metoda Put slouží k určení oblasti mezipaměti pro objekt. Pokud tato oblast v mezipaměti ještě neexistuje, je vrácen objekt DataCacheException s kódem chyby RegionDoesNotExist. V tomto příkladu je tato chyba zpracována vytvořením oblasti a opakováním operace 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");
   }
}

Další odkazy

Koncepty

Obecné výjimky (ukládání do mezipaměti technologie Windows Server AppFabric)
Konfigurace časových limitů klienta mezipaměti (ukládání do mezipaměti technologie Windows Server AppFabric)

  2011-12-05