ISerializable Rozhraní

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

ISerializable.cs

Umožňuje objektu řídit vlastní serializace a deserializace prostřednictvím binární a XML serializace.

public interface class ISerializable

public interface ISerializable

type ISerializable = interface

Public Interface ISerializable

Odvozené

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

Poznámky

Všechny třídy, které mohou být serializovány pomocí binární nebo XML serializace musí být označeny SerializableAttribute. Pokud třída potřebuje řídit svůj binární nebo XML serializace procesu, může implementovat ISerializable rozhraní. Volání Formatter v GetObjectData době serializace a naplní dodané SerializationInfo všemi daty potřebnými k reprezentaci objektu. Vytvoří Formatter typ SerializationInfo objektu v grafu. Objekty, které potřebují odesílat proxy pro sebe, mohou použít FullTypeName a AssemblyName metody SerializationInfo ke změně přenášených informací.

V případě dědičnosti tříd je možné serializovat třídu, která je odvozena od základní třídy, která implementuje ISerializable. V tomto případě by odvozená třída měla volat základní třídu implementace GetObjectData uvnitř své implementace GetObjectData. V opačném případě nebudou data ze základní třídy serializována.

Rozhraní ISerializable implikuje konstruktor s podpisem constructor (SerializationInfo information, StreamingContext context). V době deserializace je aktuální konstruktor volán pouze po deserializaci dat v SerializationInfo rekonstruktoru. Obecně platí, že tento konstruktor by měl být protected , pokud třída není sealed.

Pořadí, ve kterém jsou objekty deserializovány, nelze zaručit. Pokud například jeden typ odkazuje na typ, který ještě nebyl deserializován, dojde k výjimce. Pokud vytváříte typy, které mají takové závislosti, můžete problém vyřešit implementací IDeserializationCallback rozhraní a OnDeserialization metody.

Architektura serializace zpracovává typy objektů, které rozšiřují MarshalByRefObject stejné typy jako typy, které rozšiřují Object. Tyto typy lze označit SerializableAttribute a implementovat rozhraní jako jakýkoli jiný typ objektu ISerializable . Jejich stav objektu se zachytí a zachytí do datového proudu.

Při použití System.Runtime.Remotingtěchto typů prostřednictvím , remoting infrastruktura poskytuje náhradní, která předpyší typické serializace a místo toho serializuje proxy na MarshalByRefObject. Náhradní je pomocník, který ví, jak serializovat a deserializovat objekty určitého typu. Proxy, neviditelný pro uživatele ve většině případů, bude typu ObjRef.

Jako obecný vzor návrhu by bylo neobvyklé, aby třída byla označena serializovatelným atributem a rozšířit MarshalByRefObject. Vývojáři by měli pečlivě zvážit možné scénáře serializace a vzdálené komunikace při kombinování těchto dvou charakteristik. Jedním z příkladů, kde to může být použitelné, je s MemoryStream. I když se základní třída MemoryStream (Stream) rozšiřuje od MarshalByRefObject, je možné zachytit stav a MemoryStream obnovit ho podle vůle. Proto může být smysluplné serializovat stav tohoto datového proudu do databáze a obnovit ho později v čase. Při použití prostřednictvím vzdálené komunikace by však byl objekt tohoto typuxiován.

Další informace o serializaci tříd, které rozšiřují MarshalByRefObject, naleznete v tématu RemotingSurrogateSelector. Další informace o implementaci ISerializablenaleznete v tématu Vlastní serializace.

Note

Toto rozhraní se nevztahuje na serializaci JSON pomocí System.Text.Json.

Poznámky pro implementátory

Implementujte toto rozhraní, aby se objekt mohl účastnit vlastní serializace a deserializace.

Metody

Name	Description
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní SerializationInfo data potřebná k serializaci cílového objektu.

Viz také

• RemotingSurrogateSelector
• Serializace XML a SOAP
• Vlastní serializace