AnyObjectSerializerWrapper Class


AnyObjectSerializerWrapper Class	KGy SOFT Core Libraries Help

Provides a wrapper class for serializing any kind of object, including the ones that are not marked by the SerializableAttribute, or which are not supported by BinaryFormatter. Can be useful when an object cannot be serialized by BinarySerializationFormatter so a BinaryFormatter must be used. When this object is deserialized, the clone of the wrapped original object is returned.
See the Remarks section for details.

Inheritance Hierarchy

SystemObject
KGySoft.Serialization.BinaryAnyObjectSerializerWrapper

Namespace: KGySoft.Serialization.Binary
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 5.0.0

Syntax

C++

Copy

[SerializableAttribute]
public sealed class AnyObjectSerializerWrapper : ISerializable, 
	IObjectReference

<SerializableAttribute>
Public NotInheritable Class AnyObjectSerializerWrapper
	Implements ISerializable, IObjectReference

[SerializableAttribute]
public ref class AnyObjectSerializerWrapper sealed : ISerializable, 
	IObjectReference

[<SealedAttribute>]
[<SerializableAttribute>]
type AnyObjectSerializerWrapper =  
    class
        interface ISerializable
        interface IObjectReference
    end

The AnyObjectSerializerWrapper type exposes the following members.

Constructors

	Name	Description
	AnyObjectSerializerWrapper	Creates a new instance of AnyObjectSerializerWrapper with the provided object to be serialized.

Top

Methods

	Name	Description
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Extension Methods

	Name	Description
	Convert(Type, CultureInfo)	Overloaded. Converts an Object specified in the obj parameter to the desired targetType. See the Examples section of the generic ConvertTTarget(Object, CultureInfo) overload for an example. (Defined by ObjectExtensions.)
	ConvertTTarget(CultureInfo)	Overloaded. Converts an Object specified in the obj parameter to the desired TTarget. (Defined by ObjectExtensions.)
	In	Gets whether item is among the elements of set. See the Examples section of the generic InT(T, T) overload for an example. (Defined by ObjectExtensions.)
	TryConvert(Type, Object)	Overloaded. Tries to convert an Object specified in the obj parameter to the desired targetType. (Defined by ObjectExtensions.)
	TryConvert(Type, CultureInfo, Object)	Overloaded. Tries to convert an Object specified in the obj parameter to the desired targetType. (Defined by ObjectExtensions.)
	TryConvertTTarget(TTarget)	Overloaded. Tries to convert an Object specified in the obj parameter to the desired TTarget. See the Examples section of the ConvertTTarget(Object, CultureInfo) method for a related example. (Defined by ObjectExtensions.)
	TryConvertTTarget(CultureInfo, TTarget)	Overloaded. Tries to convert an Object specified in the obj parameter to the desired TTarget. See the Examples section of the ConvertTTarget(Object, CultureInfo) method for a related example. (Defined by ObjectExtensions.)

Top

Remarks

Since BinarySerializationFormatter supports serialization of any class, this object is not necessarily needed when BinarySerializationFormatter is used.

In .NET Framework this class supports serialization of remote objects, too.

Caution
This class cannot guarantee that an object serialized in a framework can be deserialized in another one. For such cases some text-based serialization might be better (see also the XmlSerializer). In .NET Core the ISerializable implementation of some types throw a PlatformNotSupportedException. For such cases setting the forceSerializationByFields in the constructor can be a solution. For a more flexible customization use the CustomSerializerSurrogateSelector class instead.

Caution

This class cannot guarantee that an object serialized in a framework can be deserialized in another one. For such cases some text-based serialization might be better (see also the XmlSerializer).

In .NET Core the ISerializable implementation of some types throw a PlatformNotSupportedException. For such cases setting the forceSerializationByFields in the constructor can be a solution.

For a more flexible customization use the CustomSerializerSurrogateSelector class instead.

Reference

KGySoft.Serialization.Binary Namespace