Serialisierung für Azure Managed Cache Service

Wichtig

Microsoft empfiehlt, alle neuen Entwicklungen azure Redis Cache zu verwenden. Für aktuelle Dokumentation und Anleitungen zur Auswahl eines Azure Cache-Angebots finden Sie unter Welches Azure Cache-Angebot ist für mich richtig?

Microsoft Azure Cache unterstützt drei verschiedene Modi der Serialisierung. Jedes im Cache gespeicherte Element muss zuerst in einen persistenten Datenstrom serialisiert werden. Jedes Element, das aus dem Cache abgerufen wird, muss zurück in sein Objektformat deserialisiert werden. In diesem Thema werden die in der Zwischenspeicherung verfügbaren Serialisierungsoptionen beschrieben.

Serialisierungstypen

In der folgenden Tabelle werden die drei Serialisierungstypen beschrieben.

Konfigurationseinstellung BESCHREIBUNG

NetDataContractSerializer

Serialisiert Objekte mit der NetDataContractSerializer-Klasse . Dies ist die Standardoption.

Binaryformatter

Serialisiert Objekte mit der BinaryFormatter-Klasse .

CustomSerializer

Serialisiert Objekte mithilfe einer benutzerdefinierten Serialisierungsklasse, die von der Anwendung bereitgestellt wird.

Wenn keine Serialisierungsoption angegeben wird, verwendet die Zwischenspeicherung den NetDataContractSerializer. Beachten Sie, dass alle Klassen, die im Cache gespeichert sind, als Serializierbar gekennzeichnet werden müssen.

In der Konfigurationsdatei können Sie das SerializationProperties-Element als untergeordnetes Element des DataCacheClient-Elements angeben. Im folgenden Beispiel wird ein DataCacheClients-Abschnitt mit zwei benannten Cacheclients veranschaulicht. Der Standardcacheclient verwendet Standardserialisierung, und der zweite Cacheclient gibt binäre Serialisierung an.

<dataCacheClients>
  <dataCacheClient name="default">
    <!-- Other configuration settings for cache omitted -->
  </dataCacheClient>
  <dataCacheClient name="binaryConfig">
    <serializationProperties serializer="BinaryFormatter" />
    <!-- Other configuration settings for cache omitted -->
  </dataCacheClient>
</dataCacheClients>

Das folgende Beispiel zeigt, wie Sie mithilfe von Code auf diese Cacheclientkonfigurationen zugreifen können.

// "default" cache client configuration, "default" cache:
DataCache cacheTest1 = new DataCache();
cacheTest1.Put("test", "test");

// "binaryConfig" cache client configuration, "default" cache:
DataCache cacheTest2 = new DataCache("default", "binaryConfig");
cacheTest2.Put("test", "test");

Für benutzerdefinierte Serialisierung ist keine zusätzliche Codierung erforderlich. Weitere Informationen finden Sie unter How to: Use a Custom Serializer with Azure In-Role Cache.

Hinweis

Das programmgesteuerte Äquivalent des SerializationProperties-Elements ist die DataCacheSerializationProperties-Klasse. Die Eigenschaften für diese Klasse entsprechen den gleichen drei Serialisierungstypen. Diese Enumeration wird der DataCacheFactoryConfiguration.SerializationProperties-Eigenschaft zugewiesen.

Wichtig

Die ASP.NET Anbieter für die Zwischenspeicherung unterstützen keine binären oder benutzerdefinierten Serialisierungstypen.

Weitere Informationen

Weitere Ressourcen

Funktionen von Azure Managed Cache Service