IReliableStateManager.TryAddStateSerializer<T> Methode

Definition

Namespace:

Microsoft.ServiceFabric.Data

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.dll

Paket:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Registriert einen benutzerdefinierten Serialisierer für alle zuverlässigen Sammlungen.

public bool TryAddStateSerializer<T> (Microsoft.ServiceFabric.Data.IStateSerializer<T> stateSerializer);

abstract member TryAddStateSerializer : Microsoft.ServiceFabric.Data.IStateSerializer<'T> -> bool

Public Function TryAddStateSerializer(Of T) (stateSerializer As IStateSerializer(Of T)) As Boolean

Typparameter

T

Typ, der serialisiert und deserialisiert wird.

Parameter

stateSerializer

IStateSerializer<T>

Der hinzuzufügende Zustandsserialisierer.

Gibt zurück

Boolean

True, wenn das benutzerdefinierte Serialisierungsprogramm hinzugefügt wurde. False, wenn bereits ein benutzerdefiniertes Serialisierungsprogramm für den angegebenen Typ vorhanden ist.

Hinweise

Wenn eine zuverlässige Auflistung ein Objekt serialisieren muss, fragt sie den Zustands-Manager nach einem Serialisierungsprogramm für den angegebenen Typ. Der Zustands-Manager überprüft zunächst, ob ein benutzerdefiniertes Serialisierungsprogramm für den Eingabetyp registriert ist. Ist dies nicht der Fall, wird überprüft, ob eines der integrierten Serialisierungsprogramme den Typ serialisieren kann. Der Zustands-Manager verfügt über integrierte Serialisierer für die folgenden Typen: guid, bool, byte, sbyte, char, decimal, double, float, int, uint, long, ulong, short, ushort und string. Andernfalls wird verwendet DataContractSerializer.

Serialisierer müssen unendlich vorwärts- und abwärtskompatibel sein. Für die Typen, die integrierte Serialisierungsprogramme verwenden, stellt Service Fabric Aufwärts- und Abwärtskompatibilität sicher. Wenn jedoch ein benutzerdefiniertes Serialisierer für einen Typ mit einem integrierten Serialisierungsprogramm hinzugefügt wird, muss der benutzerdefinierte Serialisierer mit dem integrierten Serialisierungsformat für diesen Typ kompatibel sein.

Diese Methode sollte vom Konstruktor des Stateful Service aufgerufen werden. Dadurch wird sichergestellt, dass die Reliable Collections über die erforderlichen Serialisierer verfügen, bevor die Wiederherstellung des persistenten Zustands beginnt.