ISerializable Interfész

Definíció

Névtér:

System.Runtime.Serialization

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

ISerializable.cs

Lehetővé teszi, hogy egy objektum bináris és XML-szerializálással vezérelje saját szerializálását és deszerializálását.

public interface class ISerializable

public interface ISerializable

type ISerializable = interface

Public Interface ISerializable

Származtatott

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

Megjegyzések

Minden olyan osztályt, amely bináris vagy XML szerializálással szerializálható, meg kell jelölni a SerializableAttribute. Ha egy osztálynak szabályoznia kell a bináris vagy XML szerializálási folyamatát, megvalósíthatja az interfészt ISerializable . A Formatter rendszer meghívja a GetObjectData szerializálási időpontot, és feltölti a megadott SerializationInfo adatokat az objektum megjelenítéséhez szükséges összes adattal. Az Formatter objektum a gráfban lévő objektum típusával jön létre SerializationInfo . Azoknak az objektumoknak, amelyeknek proxykat kell küldeniük maguknak, használhatják a FullTypeName továbbított információk módosítására szolgáló módszereket és AssemblyName módszereket SerializationInfo .

Osztályöröklés esetén lehetőség van olyan osztály szerializálására, amely egy implementálandó alaposztályból származik ISerializable. Ebben az esetben a származtatott osztálynak az alaposztály implementálását GetObjectData kell meghívnia annak megvalósításán GetObjectDatabelül. Ellenkező esetben az alaposztály adatai nem lesznek szerializálva.

Az ISerializable interfész egy konstruktort feltételez az aláírással constructor (SerializationInfo information, StreamingContext context). Deszerializáláskor a rendszer csak akkor hívja meg az aktuális konstruktort, ha a formázó deszerializálta a benne lévő SerializationInfo adatokat. Ennek a konstruktornak általában akkor kell lennie protected , ha az osztály nem sealed.

Az objektumok deszerializálásának sorrendje nem garantálható. Ha például egy típus egy még nem deszerializált típusra hivatkozik, kivétel történik. Ha ilyen függőségekkel rendelkező típusokat hoz létre, az interfész és a metódus implementálásával megkerülheti a IDeserializationCallbackOnDeserialization problémát.

A szerializálási architektúra azokat az objektumtípusokat kezeli, amelyek ugyanúgy terjednek ki MarshalByRefObject , mint a kiterjesztő Objecttípusok. Ezek a típusok megjelölhetők az SerializableAttribute illesztővel, és bármilyen más objektumtípusként implementálhatók ISerializable . A rendszer rögzíti és megőrzi az objektum állapotát a streamben.

Ha ezeket a típusokat használja System.Runtime.Remoting, az újraírási infrastruktúra egy helyettesítő szolgáltatást biztosít, amely a tipikus szerializálást előz meg, és ehelyett szerializálja a proxyt a MarshalByRefObject. A helyettes egy segítő, aki tudja, hogyan szerializálhatja és deszerializálhatja az adott típusú objektumokat. A proxy, amely a legtöbb esetben nem látható a felhasználó számára, típusának ObjRefkell lennie.

Általános tervezési mintaként szokatlan lenne, ha egy osztályt szerializálható attribútummal jelölnének meg, és kiterjesztenének MarshalByRefObject. A fejlesztőknek alaposan át kell gondolniuk a lehetséges szerializálási és újraegyesítési forgatókönyveket a két jellemző kombinálásakor. Az egyik példa, ahol ez alkalmazható lehet, MemoryStreamegy . Bár a () alaposztálya MemoryStream kiterjeszthetőStream, lehetőség van az állapot MarshalByRefObject rögzítésére és a visszaállításra.MemoryStream Ezért érdemes lehet a stream állapotát egy adatbázisba szerializálni, és egy későbbi időpontban visszaállítani. Ha azonban újraírással használják, az ilyen típusú objektumok ki vannak próbálva.

További információ a kiterjesztett MarshalByRefObjectosztályok szerializálásáról: RemotingSurrogateSelector. A megvalósításról ISerializabletovábbi információt az Egyéni szerializálás című témakörben talál.

Note

Ez a felület nem vonatkozik a JSON-szerializálásra a következő használatával System.Text.Json: .

Megjegyzések az implementálókhoz

Implementálja ezt az interfészt, hogy lehetővé tegye egy objektum számára, hogy részt vegyen saját szerializálásában és deszerializálásában.

Metódusok

Name	Description
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Feltölti a SerializationInfo célobjektum szerializálásához szükséges adatokat.

Lásd még

• RemotingSurrogateSelector
• XML- és SOAP-szerializálás
• Egyéni szerializálás