ISerializable 인터페이스

정의

네임스페이스:

System.Runtime.Serialization

어셈블리:

System.Runtime.dll

개체가 이진 및 XML serialization을 통해 자체 직렬화 및 역직렬화를 제어할 수 있도록 허용합니다.

public interface class ISerializable

public interface ISerializable

type ISerializable = interface

Public Interface ISerializable

파생

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

설명

이진 또는 XML serialization을 사용하여 serialize할 수 있는 모든 클래스는 로 SerializableAttribute표시되어야 합니다. 클래스가 이진 또는 XML serialization 프로세스를 제어해야 하는 경우 인터페이스를 구현할 ISerializable 수 있습니다. 는 Formatter serialization 시 를 GetObjectData 호출하고 제공된 SerializationInfo 를 개체를 나타내는 데 필요한 모든 데이터로 채웁니다. 는 Formatter 그래프에 개체의 형식을 사용하여 을 만듭니다 SerializationInfo . 프록시를 직접 보내야 하는 개체는 및 AssemblyName 메서드를 FullTypeNameSerializationInfo 사용하여 전송된 정보를 변경할 수 있습니다.

클래스 상속의 경우 를 구현하는 기본 클래스에서 파생되는 클래스를 serialize할 수 있습니다.ISerializable 이 경우 파생 클래스는 의 구현 GetObjectData내에서 의 GetObjectData 기본 클래스 구현을 호출해야 합니다. 그렇지 않으면 기본 클래스의 데이터가 직렬화되지 않습니다.

인터페이스는 ISerializable 서명 constructor (SerializationInfo information, StreamingContext context)이 인 생성자를 의미합니다. 역직렬화 시 현재 생성자는 의 데이터가 포맷터에 SerializationInfo 의해 역직렬화된 후에만 호출됩니다. 일반적으로 클래스가 이 아닌 sealed경우 이 생성자는 이어야 합니다protected.

개체가 역직렬화되는 순서는 보장할 수 없습니다. 예를 들어 한 형식이 아직 역직렬화되지 않은 형식을 참조하는 경우 예외가 발생합니다. 이러한 종속성이 있는 형식을 만드는 경우 인터페이스 및 OnDeserialization 메서드를 구현하여 IDeserializationCallback 문제를 해결할 수 있습니다.

serialization 아키텍처는 를 확장하는 Object형식과 동일하게 확장 MarshalByRefObject 되는 개체 형식을 처리합니다. 이러한 형식은 로 SerializableAttribute 표시하고 인터페이스를 ISerializable 다른 개체 형식으로 구현할 수 있습니다. 해당 개체 상태는 캡처되어 스트림에 유지됩니다.

이러한 형식을 통해 System.Runtime.Remoting사용되는 경우 원격 인프라는 일반적인 serialization을 선점하고 대신 프록시를 로 직렬화하는 서로게이트를 MarshalByRefObject제공합니다. 서로게이트는 특정 형식의 개체를 직렬화하고 역직렬화하는 방법을 알고 있는 도우미입니다. 대부분의 경우 사용자에게 보이지 않는 프록시는 형식 ObjRef입니다.

일반적인 디자인 패턴으로 클래스가 직렬화 가능한 특성으로 표시되고 를 확장하는 MarshalByRefObject것은 드문 일입니다. 개발자는 이러한 두 특성을 결합할 때 가능한 직렬화 및 원격 시나리오에 대해 신중하게 생각해야 합니다. 이를 적용할 수 있는 한 가지 예는 를 사용하는 MemoryStream것입니다. ()의 MemoryStream 기본 클래스는 에서 MarshalByRefObject확장되지만 의 MemoryStream 상태를 캡처하고 의지에 따라 복원할 수Stream 있습니다. 따라서 이 스트림의 상태를 데이터베이스로 직렬화하고 나중에 복원하는 것이 의미가 있을 수 있습니다. 그러나 원격을 통해 사용하면 이 형식의 개체가 프록시됩니다.

를 확장하는 MarshalByRefObject클래스의 serialization에 대한 자세한 내용은 를 참조하세요 RemotingSurrogateSelector. 구현에 대한 자세한 내용은 사용자 지정 Serialization을 ISerializable참조하세요.

참고

이 인터페이스는 를 사용하는 JSON serialization에는 System.Text.Json적용되지 않습니다.

구현자 참고

개체가 자체 직렬화 및 역직렬화에 참여할 수 있도록 이 인터페이스를 구현합니다.

메서드

GetObjectData(SerializationInfo, StreamingContext)

사용되지 않음. 대상 개체를 직렬화하는 데 필요한 데이터로 SerializationInfo를 채웁니다.

추가 정보

• RemotingSurrogateSelector
• XML 및 SOAP serialization
• 사용자 지정 serialization