ISerializable Rozhraní

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

System.Runtime.dll

Umožňuje objektu řídit jeho 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

Každá třída, která může být serializována pomocí binárního nebo XML serializace musí být označena SerializableAttributepomocí . Pokud třída potřebuje řídit svůj binární nebo XML serializace proces, může implementovat ISerializable rozhraní. GetObjectData Volání Formatter v čase serializace a naplní dodanou SerializationInfo všechna data potřebná k reprezentaci objektu. Objekt Formatter vytvoří SerializationInfo typ objektu v grafu. Objekty, které potřebují odesílat proxy servery pro sebe, můžou ke změně přenášených informací použít FullTypeName metody SerializationInfo a AssemblyName .

V případě dědičnosti třídy je možné serializovat třídu, která je odvozena ze základní třídy, která implementuje ISerializable. V tomto případě by odvozená třída měla volat implementaci GetObjectData základní třídy 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 data v souboru SerializationInfo byla deserializována formátovacím nástrojem. 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 obejít implementací IDeserializationCallback rozhraní a OnDeserialization metody .

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

Při použití těchto typů prostřednictvím System.Runtime.Remotingnástroje poskytuje infrastruktura vzdálené komunikace náhradu, která předchází typické serializaci a místo toho serializuje proxy server do .MarshalByRefObject Náhradní je pomocník, který ví, jak serializovat a deserializovat objekty určitého typu. Proxy server, který uživatel ve většině případů nevidí, 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 by to mohlo být použitelné, je .MemoryStream Zatímco základní třída MemoryStream (Stream) se rozšiřuje z MarshalByRefObject, je možné zachytit stav objektu MemoryStream a obnovit ho podle své vůle. Proto může být smysluplné serializovat stav tohoto streamu do databáze a později ho obnovit. Při použití prostřednictvím vzdálené komunikace by však objekt tohoto typu byl proxy.

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.

Poznámka

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

GetObjectData(SerializationInfo, StreamingContext)

Zastaralé. Naplní SerializationInfo objekt daty potřebnými k serializaci cílového objektu.

Viz také

• RemotingSurrogateSelector
• Serializace XML a SOAP
• Vlastní serializace