ISerializable Antarmuka

Definisi

Ruang nama:

System.Runtime.Serialization

Rakitan:

System.Runtime.dll

Memungkinkan objek untuk mengontrol serialisasi dan deserialisasinya sendiri melalui serialisasi biner dan XML.

public interface class ISerializable

public interface ISerializable

type ISerializable = interface

Public Interface ISerializable

Turunan

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

Keterangan

Kelas apa pun yang mungkin diserialisasikan menggunakan serialisasi biner atau XML harus ditandai dengan SerializableAttribute. Jika kelas perlu mengontrol proses serialisasi biner atau XML-nya, kelas dapat mengimplementasikan ISerializable antarmuka. Formatter memanggil GetObjectData pada waktu serialisasi dan mengisi yang disediakan SerializationInfo dengan semua data yang diperlukan untuk mewakili objek. Formatter membuat SerializationInfo dengan jenis objek dalam grafik. Objek yang perlu mengirim proksi untuk diri mereka sendiri dapat menggunakan FullTypeName metode dan AssemblyName pada SerializationInfo untuk mengubah informasi yang dikirimkan.

Dalam kasus pewarisan kelas, dimungkinkan untuk membuat serial kelas yang berasal dari kelas dasar yang mengimplementasikan ISerializable. Dalam hal ini, kelas turunan harus memanggil implementasi kelas dasar di GetObjectData dalam implementasinya GetObjectData. Jika tidak, data dari kelas dasar tidak akan diserialisasikan.

Antarmuka ISerializable menyiratkan konstruktor dengan tanda tangan constructor (SerializationInfo information, StreamingContext context). Pada waktu deserialisasi, konstruktor saat ini dipanggil hanya setelah data dalam telah dideserialisasi SerializationInfo oleh pemformat. Secara umum, konstruktor ini harus protected jika kelas bukan sealed.

Urutan di mana objek dideserialisasi tidak dapat dijamin. Misalnya, jika satu jenis mereferensikan jenis yang belum dideserialisasi, pengecualian akan terjadi. Jika Anda membuat jenis yang memiliki dependensi seperti itu, Anda dapat mengatasi masalah dengan menerapkan IDeserializationCallback antarmuka dan OnDeserialization metode .

Arsitektur serialisasi menangani jenis objek yang diperluas MarshalByRefObject sama dengan jenis yang diperluas Object. Jenis-jenis ini dapat ditandai dengan SerializableAttribute dan mengimplementasikan ISerializable antarmuka sebagai jenis objek lainnya. Status objek mereka akan ditangkap dan dipertahankan ke aliran.

Ketika jenis ini digunakan melalui System.Runtime.Remoting, infrastruktur jarak jauh menyediakan pengganti yang mendahului serialisasi khas dan sebaliknya menserialisasikan proksi ke MarshalByRefObject. Pengganti adalah pembantu yang tahu cara membuat serialisasi dan deserialisasi objek dari jenis tertentu. Proksi, tidak terlihat oleh pengguna dalam banyak kasus, akan berjenis ObjRef.

Sebagai pola desain umum, tidak biasa kelas ditandai dengan atribut yang dapat diserialisasikan dan diperluas MarshalByRefObject. Pengembang harus berpikir dengan cermat tentang kemungkinan serialisasi dan skenario jarak jauh saat menggabungkan kedua karakteristik ini. Salah satu contoh di mana ini mungkin berlaku adalah dengan MemoryStream. Sementara kelas MemoryStream dasar (Stream) meluas dari MarshalByRefObject, dimungkinkan untuk menangkap status MemoryStream dan memulihkannya sesering mungkin. Oleh karena itu, mungkin bermakna untuk menserialisasikan status aliran ini ke dalam database dan memulihkannya di beberapa titik waktu kemudian. Namun, ketika digunakan melalui jarak jauh, objek jenis ini akan diproksikan.

Untuk informasi selengkapnya tentang serialisasi kelas yang diperluas MarshalByRefObject, lihat RemotingSurrogateSelector. Untuk informasi selengkapnya tentang penerapan ISerializable, lihat Serialisasi Kustom.

Catatan

Antarmuka ini tidak berlaku untuk serialisasi JSON menggunakan System.Text.Json.

Catatan Bagi Implementer

Terapkan antarmuka ini untuk memungkinkan objek mengambil bagian dalam serialisasi dan deserialisasinya sendiri.

Metode

GetObjectData(SerializationInfo, StreamingContext)

Kedaluwarsa. Mengisi dengan data yang SerializationInfo diperlukan untuk membuat serialisasi objek target.

Lihat juga

• RemotingSurrogateSelector
• Serialisasi XML dan SOAP
• Serialisasi Kustom