ISerializable Arabirim

Tanım

Ad Alanı:

System.Runtime.Serialization

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir nesnenin ikili ve XML serileştirme aracılığıyla kendi serileştirmesini ve seri durumdan çıkarılmasını denetlemesine izin verir.

public interface class ISerializable

public interface ISerializable

type ISerializable = interface

Public Interface ISerializable

Türetilmiş

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

Açıklamalar

İkili veya XML serileştirme kullanılarak seri hale getirilebilen tüm sınıflar ile SerializableAttributeişaretlenmelidir. Bir sınıfın ikili veya XML serileştirme işlemini denetlemesi gerekiyorsa arabirimini ISerializable uygulayabilir. serileştirme Formatter zamanında öğesini GetObjectData çağırır ve sağlanan SerializationInfo öğesini nesneyi temsil etmek için gereken tüm verilerle doldurur. , Formatter grafikteki nesnenin türüyle bir SerializationInfo oluşturur. Kendileri için proxy göndermesi gereken nesneler, iletilen bilgileri değiştirmek için ve AssemblyName yöntemlerini SerializationInfo kullanabilirFullTypeName.

Sınıf devralma durumunda, uygulayan ISerializablebir temel sınıftan türetilen bir sınıfı seri hale getirmek mümkündür. Bu durumda türetilmiş sınıf, uygulamasının içinde temel sınıf uygulamasını GetObjectDataGetObjectDataçağırmalıdır. Aksi takdirde, temel sınıftaki veriler seri hale getirilmeyecek.

ISerializable arabirimi, imzası constructor (SerializationInfo information, StreamingContext context)olan bir oluşturucuyu ifade eder. Seri durumdan çıkarma zamanında, geçerli oluşturucu yalnızca içindeki SerializationInfo veriler biçimlendirici tarafından seri durumdan çıkarıldıktan sonra çağrılır. Genel olarak, sınıfı değilse sealedbu oluşturucu olmalıdırprotected.

Nesnelerin seri durumdan çıkarılma sırası garanti edilemez. Örneğin, bir tür henüz seri durumdan çıkarılmamış bir türe başvurursa, bir özel durum oluşur. Bu tür bağımlılıklara sahip türler oluşturuyorsanız, arabirimini ve OnDeserialization yöntemini uygulayarak IDeserializationCallback soruna geçici bir çözüm bulabilirsiniz.

Serileştirme mimarisi, genişleten türlerle aynı genişleten MarshalByRefObjectObjectnesne türlerini işler. Bu türler ile SerializableAttribute işaretlenebilir ve arabirimini ISerializable başka bir nesne türü olarak uygulayabilir. Nesne durumu yakalanır ve akışta kalıcı hale getirilir.

Bu türler aracılığıyla System.Runtime.Remotingkullanıldığında uzaktan iletişim altyapısı, tipik serileştirmeyi önleyen ve bunun yerine proxy'yi MarshalByRefObjectiçin seri hale getiren bir vekil sağlar. Vekil, belirli bir türdeki nesneleri seri hale getirme ve seri durumdan çıkarma konusunda bilgi sahibi olan bir yardımcıdır. Çoğu durumda kullanıcıya görünmeyen ara sunucu türünde ObjRefolacaktır.

Genel bir tasarım deseni olarak, bir sınıfın hem serializable özniteliğiyle işaretlenmesi hem de kapsamını genişletmesi MarshalByRefObjectolağan dışı olacaktır. Geliştiriciler bu iki özelliği birleştirirken olası serileştirme ve uzaktan iletişim senaryoları hakkında dikkatli düşünmelidir. Bunun uygulanabileceği durumlardan biri ile MemoryStreamolabilir. temel sınıfı MemoryStream (Stream) öğesinden MarshalByRefObjectgenişletilirken, bir MemoryStream durumunu yakalamak ve istediğiniz zaman geri yüklemek mümkündür. Bu nedenle, bu akışın durumunu bir veritabanına seri hale getirmek ve daha sonra geri yüklemek anlamlı olabilir. Ancak, uzaktan iletişim aracılığıyla kullanıldığında, bu tür bir nesne proksied olacaktır.

genişleten MarshalByRefObjectsınıfların seri hale getirilmesi hakkında daha fazla bilgi için bkz RemotingSurrogateSelector. . uygulama ISerializablehakkında daha fazla bilgi için bkz. Özel Serileştirme.

Not

Bu arabirim, kullanarak System.Text.JsonJSON serileştirmesi için geçerli değildir.

Uygulayanlara Notlar

Bir nesnenin kendi serileştirme ve seri durumdan çıkarma işlemine katılmasını sağlamak için bu arabirimi uygulayın.

Yöntemler

GetObjectData(SerializationInfo, StreamingContext)

Geçersiz. hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo .

Ayrıca bkz.

• RemotingSurrogateSelector
• XML ve SOAP Serileştirme
• Özel serileştirme