ISerializable Interfejs

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestaw:

System.Runtime.dll

Umożliwia obiektowi kontrolowanie własnej serializacji i deserializacji za pomocą serializacji binarnej i XML.

public interface class ISerializable

public interface ISerializable

type ISerializable = interface

Public Interface ISerializable

Pochodne

System.ActivationContext

System.Activities.ExpressionParser.SourceExpressionException

System.ApplicationIdentity

System.Collections.Comparer

System.Collections.Generic.Dictionary<TKey,TValue>

System.Collections.Generic.HashSet<T>

System.Collections.Generic.LinkedList<T>

System.Collections.Generic.LinkedList<T>.Enumerator

System.Collections.Generic.SortedSet<T>

System.Collections.Generic.SortedSet<T>.Enumerator

System.Collections.Hashtable

System.Collections.Specialized.NameObjectCollectionBase

System.Collections.Specialized.OrderedDictionary

System.Data.DataSet

System.Data.DataTable

System.Data.SqlTypes.SqlBytes

System.Data.SqlTypes.SqlChars

System.Data.SqlTypes.SqlGuid

System.DateTime

System.DateTimeOffset

System.DBNull

System.Decimal

System.Delegate

System.Diagnostics.EventLogEntry

System.DirectoryServices.ActiveDirectory.ActiveDirectoryObjectNotFoundException

System.DirectoryServices.ActiveDirectory.ActiveDirectoryOperationException

System.DirectoryServices.ActiveDirectory.ActiveDirectoryServerDownException

System.DirectoryServices.ActiveDirectory.ForestTrustCollisionException

System.DirectoryServices.ActiveDirectory.SyncFromAllServersOperationException

System.DirectoryServices.DirectoryServicesCOMException

System.DirectoryServices.Protocols.DirectoryOperationException

System.DirectoryServices.Protocols.ErrorResponseException

System.DirectoryServices.Protocols.LdapException

System.Drawing.Design.ToolboxItem

System.Drawing.Design.ToolboxItemContainer

System.Drawing.Font

System.Drawing.Icon

System.Drawing.Image

System.Exception

System.IdentityModel.Protocols.WSTrust.WSTrustSerializationException

System.IdentityModel.Services.FederatedAuthenticationSessionEndingException

System.IdentityModel.Tokens.BootstrapContext

System.IdentityModel.Tokens.SessionSecurityToken

System.IntPtr

System.IO.DriveInfo

System.IO.FileSystemInfo

System.Management.ManagementBaseObject

System.Media.SoundPlayer

System.Messaging.MessageQueueException

System.Net.CookieException

System.Net.FileWebRequest

System.Net.FileWebResponse

System.Net.HttpWebRequest

System.Net.HttpWebResponse

System.Net.PeerToPeer.Cloud

System.Net.PeerToPeer.Collaboration.Peer

System.Net.PeerToPeer.Collaboration.PeerApplication

System.Net.PeerToPeer.Collaboration.PeerContact

System.Net.PeerToPeer.Collaboration.PeerEndPoint

System.Net.PeerToPeer.Collaboration.PeerNearMe

System.Net.PeerToPeer.Collaboration.PeerObject

System.Net.PeerToPeer.PeerName

System.Net.PeerToPeer.PeerNameRecord

System.Net.PeerToPeer.PeerNameRegistration

System.Net.PeerToPeer.PeerToPeerException

System.Net.ProtocolViolationException

System.Net.WebException

System.Net.WebHeaderCollection

System.Net.WebProxy

System.Net.WebRequest

System.Net.WebResponse

System.OperatingSystem

System.Printing.IndexedProperties.PrintPropertyDictionary

System.Reflection.Assembly

System.Reflection.AssemblyName

System.Reflection.Missing

System.Reflection.Module

System.Reflection.Pointer

System.Reflection.StrongNameKeyPair

System.Resources.ResXDataNode

System.Runtime.Remoting.Messaging.LogicalCallContext

System.Runtime.Remoting.Messaging.MethodCall

System.Runtime.Remoting.Messaging.MethodResponse

System.Runtime.Remoting.ObjRef

System.Runtime.Serialization.Formatters.SoapFault

System.RuntimeFieldHandle

System.RuntimeMethodHandle

System.RuntimeTypeHandle

System.Security.AccessControl.PrivilegeNotHeldException

System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy

System.Security.Cryptography.X509Certificates.X509Certificate

System.Security.Policy.Hash

System.Security.Principal.WindowsIdentity

System.Speech.Recognition.RecognitionResult

System.Text.RegularExpressions.Regex

System.Text.RegularExpressions.RegexMatchTimeoutException

System.Text.StringBuilder

System.Threading.CompressedStack

System.Threading.ExecutionContext

System.TimeZoneInfo

System.TimeZoneInfo.AdjustmentRule

System.TimeZoneInfo.TransitionTime

System.Transactions.Transaction

System.UIntPtr

System.Uri

System.UriFormatException

System.WeakReference

System.WeakReference<T>

System.Web.Security.RolePrincipal

System.Web.UI.ViewStateException

System.Web.UI.WebControls.LinqDataSourceValidationException

System.Windows.Forms.AxHost.State

System.Windows.Forms.Cursor

System.Windows.Forms.ImageListStreamer

System.Windows.Forms.ListViewGroup

System.Windows.Forms.ListViewItem

System.Windows.Forms.OwnerDrawPropertyBag

System.Windows.Forms.TableLayoutSettings

System.Windows.Forms.TreeNode

System.Windows.Navigation.JournalEntry

System.Workflow.Activities.ActiveDirectoryRole

System.Workflow.Activities.Rules.RuleEvaluationException

System.Workflow.Activities.Rules.RuleEvaluationIncompatibleTypesException

System.Workflow.Activities.Rules.RuleException

System.Workflow.Activities.Rules.RuleSetValidationException

System.Workflow.ComponentModel.DependencyProperty

System.Xml.Linq.XName

Uwagi

Każda klasa, która może być serializowana przy użyciu serializacji binarnej lub XML, musi być oznaczona za pomocą .SerializableAttribute Jeśli klasa musi kontrolować proces serializacji binarnej lub XML, może zaimplementować ISerializable interfejs. Metoda Formatter wywołuje metodę GetObjectData w czasie serializacji i wypełnia dostarczone SerializationInfo ze wszystkimi danymi wymaganymi do reprezentowania obiektu. Obiekt Formatter tworzy SerializationInfo obiekt z typem obiektu na grafie. Obiekty, które muszą wysyłać serwery proxy dla siebie, mogą używać FullTypeName metod i AssemblyName w SerializationInfo celu zmiany przesyłanych informacji.

W przypadku dziedziczenia klas można serializować klasę, która pochodzi z klasy bazowej, która implementuje ISerializable. W tym przypadku klasa pochodna powinna wywołać implementację klasy bazowej GetObjectData wewnątrz implementacji klasy GetObjectData. W przeciwnym razie dane z klasy bazowej nie będą serializowane.

Interfejs ISerializable implikuje konstruktor z podpisem constructor (SerializationInfo information, StreamingContext context). W czasie deserializacji bieżący konstruktor jest wywoływany tylko wtedy, gdy dane w obiekcie SerializationInfo zostały zdeserializowane przez program formatujący. Ogólnie rzecz biorąc, ten konstruktor powinien być protected , jeśli klasa nie sealedjest .

Nie można zagwarantować kolejności deserializacji obiektów. Jeśli na przykład jeden typ odwołuje się do typu, który nie został jeszcze deserializowany, wystąpi wyjątek. Jeśli tworzysz typy, które mają takie zależności, możesz obejść problem, implementując IDeserializationCallback interfejs i metodę OnDeserialization .

Architektura serializacji obsługuje typy obiektów, które rozszerzają MarshalByRefObject te same typy, co typy rozszerzające Object. Te typy można oznaczyć za pomocą SerializableAttribute elementu i zaimplementować ISerializable interfejs jako dowolny inny typ obiektu. Ich stan obiektu zostanie przechwycony i utrwalone na strumieniu.

Gdy te typy są używane za pośrednictwem System.Runtime.Remotingprogramu , infrastruktura komunikacji sieciowej zapewnia zastępcze, które poprzedza typową serializacji, a zamiast tego serializuje serwer proxy do MarshalByRefObject. Zastępca to pomocnik, który wie, jak serializować i deserializować obiekty określonego typu. Serwer proxy niewidoczny dla użytkownika w większości przypadków będzie mieć typ ObjRef.

Jako ogólny wzorzec projektowania byłoby nietypowe, aby klasa była oznaczona atrybutem z możliwością serializacji i rozszerzała wartość MarshalByRefObject. Deweloperzy powinni dokładnie zastanowić się nad możliwymi scenariuszami serializacji i komunikacji zdalnie podczas łączenia tych dwóch cech. Jednym z przykładów, w których może to dotyczyć, jest element z elementem MemoryStream. Chociaż klasa podstawowa MemoryStream (Stream) rozciąga się od MarshalByRefObjectklasy , można przechwycić stan elementu MemoryStream i przywrócić go w woli. W związku z tym może to mieć znaczenie dla serializacji stanu tego strumienia do bazy danych i przywrócenia go w późniejszym czasie. Jednak w przypadku użycia za pośrednictwem komunikacji zdalnie obiekt tego typu będzie proxied.

Aby uzyskać więcej informacji na temat serializacji klas, które rozszerzają MarshalByRefObjectprogram , zobacz RemotingSurrogateSelector. Aby uzyskać więcej informacji na temat implementowania ISerializableprogramu , zobacz Custom Serialization (Serializacja niestandardowa).

Uwaga

Ten interfejs nie ma zastosowania do serializacji JSON przy użyciu polecenia System.Text.Json.

Uwagi dotyczące implementowania

Zaimplementuj ten interfejs, aby umożliwić obiektowi udział we własnej serializacji i deserializacji.

Metody

GetObjectData(SerializationInfo, StreamingContext)

Przestarzałe. Wypełnia element SerializationInfo danymi wymaganymi do serializacji obiektu docelowego.

Zobacz też

• RemotingSurrogateSelector
• Serializacja XML i SOAP
• Serializacja niestandardowa