DesignerSerializationManager DesignerSerializationManager DesignerSerializationManager DesignerSerializationManager Class

Definizione

Fornisce un'implementazione dell'interfaccia IDesignerSerializationManager.Provides an implementation of the IDesignerSerializationManager interface.

public ref class DesignerSerializationManager : IServiceProvider, System::ComponentModel::Design::Serialization::IDesignerSerializationManager
public class DesignerSerializationManager : IServiceProvider, System.ComponentModel.Design.Serialization.IDesignerSerializationManager
type DesignerSerializationManager = class
    interface IDesignerSerializationManager
    interface IServiceProvider
Public Class DesignerSerializationManager
Implements IDesignerSerializationManager, IServiceProvider
Ereditarietà
DesignerSerializationManagerDesignerSerializationManagerDesignerSerializationManagerDesignerSerializationManager
Implementazioni

Commenti

Il IDesignerSerializationManager interfaccia è progettata per essere un'interfaccia indipendente dal formato a un oggetto che controlla la serializzazione.The IDesignerSerializationManager interface is designed to be a format-independent interface to an object that controls serialization. Essenzialmente fornisce contesto e i servizi per i serializzatori, eseguono effettivamente la deserializzazione.It essentially provides context and services to serializers, which actually perform the deserialization. IDesignerSerializationManager offre supporto per il processo di deserializzazione tenendo traccia degli oggetti.IDesignerSerializationManager assists in the deserialization process by keeping track of objects. Questa operazione è simile in tecnica per il IDesignerHost interfaccia: le finestre di progettazione forniscono l'interfaccia utente (UI), e IDesignerHost fornisce l'associazione che consente diversi ai progettisti di collaborare.This is similar in technique to the IDesignerHost interface: designers actually provide the user interface (UI), and IDesignerHost provides the glue that allows different designers to work together.

Il DesignerSerializationManager classe implementa IDesignerSerializationManager.The DesignerSerializationManager class implements IDesignerSerializationManager. È progettato per offrire un tipo generico di deserializzazione che è simile ai serializzatori in fase di esecuzione, ad esempio il BinaryFormatter.It is designed to provide a generic form of deserialization that is similar to run-time serializers like the BinaryFormatter.

Il DesignerSerializationManager classe consente di ottenere tre obiettivi:The DesignerSerializationManager class achieves three goals:

  • È un oggetto semplice e pratico che può essere utilizzato per deserializzare una varietà di formati.It is a simple, turnkey object that can be used to deserialize a variety of formats.

  • È generico e non collegati a un particolare formato.It is generic and not tied to any particular format. Può essere utilizzato per la deserializzazione di CodeDOM, nonché la deserializzazione di markup.It can be used equally for CodeDOM deserialization as well as markup deserialization.

  • È estendibile e supporta i metodi di serializzazione diverso che vengono usati in scenari di copia/incolla e Annulla/Ripristina.It is extensible and supports different serialization methods that are used in copy/paste and undo/redo scenarios.

Serializzazione in fase di progettazione presenta le differenze seguenti dalla serializzazione di oggetti in fase di esecuzione:Design-time serialization has the following differences from run-time object serialization:

  • Oggetto che esegue la serializzazione è in genere separato dall'oggetto in fase di esecuzione, in modo che in fase di progettazione per la logica può essere rimossi da un componente.The object performing the serialization is generally separate from the run-time object, so that design-time logic can be removed from a component.

  • Lo schema di serializzazione si presuppone che verrà creato l'oggetto completamente inizializzato e quindi modificato tramite proprietà e chiamate al metodo durante la deserializzazione.The serialization scheme assumes the object will be created fully initialized, and then modified through property and method invocations during deserialization.

  • Proprietà di un oggetto con valori che sono stati mai impostati sull'oggetto (di proprietà contiene i valori predefiniti) non vengono serializzate.Properties of an object that have values that were never set on the object (the properties contain the default values) are not serialized. Al contrario, il flusso di deserializzazione potrebbe avere buchi.Conversely, the deserialization stream may have holes.

  • Particolare attenzione è rivolta la qualità del contenuto all'interno di flusso di serializzazione, anziché la serializzazione completa di un oggetto.Emphasis is placed on the quality of the content within the serialization stream, rather than the full serialization of an object. Ciò significa che, se non è definito per serializzare un oggetto, tale oggetto può essere ignorata anziché generare un'eccezione.This means that if there is no defined way to serialize an object, that object may be skipped rather than throwing an exception. Il motore di serializzazione può prevedere euristica per determinare gli errori che possono essere ignorati e che non sono recuperabili.The serialization engine may provide heuristics here to decide which failures can be ignored and which are unrecoverable.

  • Il flusso di serializzazione possa avere più dati è necessaria per la deserializzazione.The serialization stream may have more data than is needed for deserialization. La serializzazione del codice sorgente, ad esempio, ha il codice utente combinato con il codice necessario per deserializzare un oggetto grafico.Source code serialization, for example, has user code mixed in with the code needed to deserialize an object graph. Questo codice utente deve essere ignorato durante la deserializzazione e mantenuto in caso di serializzazione.This user code must be ignored on deserialization and preserved on serialization.

A causa di queste differenze, un modello di serializzazione diverso si applica a serializzazione in fase di progettazione.Because of these differences, a different serialization model applies to design-time serialization. Questo modello Usa un oggetto serializzatore separato per ogni tipo di dati in fase di serializzazione.This model utilizes a separate serializer object for each data type being serialized. Ciascun serializzatore offre il suo contributo al problema di piccole dimensioni nel suo complesso.Each serializer provides its small contribution to the problem as a whole. Questi serializzatori sono tutte le coordinate attraverso un gestore di serializzazione comuni.These serializers are all coordinated through a common serialization manager. Il gestore della serializzazione è responsabile della gestione dello stato tra questi serializzatori diversi.The serialization manager is responsible for maintaining state between these different serializers. Ad esempio, si consideri la classe seguente:As an example, consider the following class:

public class SampleObject
{
    private string stringValue = null;
    private int intValue = int.MinValue;

    public string StringProperty 
    { 
        get { return this.stringValue; }

        set { this.stringValue = value; }
    }

    public int IntProperty 
    {
        get { return this.intValue; }

        set{ this.intValue = value; }
    }
}
Public Class SampleObject
   Private stringValue As String = Nothing
   Private intValue As Integer = Integer.MinValue
   
   
   Public Property StringProperty() As String
      Get
         Return Me.stringValue
      End Get 
      Set
         Me.stringValue = value
      End Set
   End Property 
   
   Public Property IntProperty() As Integer
      Get
         Return Me.intValue
      End Get 
      Set
         Me.intValue = value
      End Set
   End Property
End Class 

Un'istanza di questa classe sarebbe utilizzare tre diversi serializzatori: uno per SampleObject, uno per le stringhe e l'altro per i numeri interi.An instance of this class would utilize three different serializers: one for SampleObject, one for strings, and another for integers. Il serializzatore SampleObject viene chiamato il serializzatore di primo livello in quanto SampleObject è la radice del grafico di serializzazione.The serializer for SampleObject is called the root serializer because SampleObject is the root of the serialization graph. È possibile creare anche oggetti grafici più complessi.More complex object graphs can be created as well. Ad esempio, si consideri cosa accadrebbe se SampleObject sono stati modificati nel modo seguente:For example, consider what would happen if SampleObject were changed as follows:

public class SampleObject
{
    private string stringValue = null;
    private int intValue = int.MinValue;
    private SampleObject childValue = null;

    public string StringProperty
    {
        get { return this.stringValue; }

        set { this.stringValue = value; }
    }

    public int IntProperty
    {
        get { return this.intValue; }

        set { this.intValue = value; }
    }

    public SampleObject Child
    {
        get { return this.childValue; }

        set { this.childValue = value; }
    }
}
Public Class SampleObject
   Private stringValue As String = Nothing
   Private intValue As Integer = Integer.MinValue
   Private childValue As SampleObject = Nothing
   
   
   Public Property StringProperty() As String
      Get
         Return Me.stringValue
      End Get 
      Set
         Me.stringValue = value
      End Set
   End Property 
   
   Public Property IntProperty() As Integer
      Get
         Return Me.intValue
      End Get 
      Set
         Me.intValue = value
      End Set
   End Property 
   
   Public Property Child() As SampleObject
      Get
         Return Me.childValue
      End Get 
      Set
         Me.childValue = value
      End Set
   End Property
End Class 

In questo modo SampleObject per avere un elemento figlio che è un'altra istanza di se stesso.This allows SampleObject to have a child that is another instance of itself. Il codice seguente viene compilato nell'oggetto grafico:The following code fills in the object graph:

class Program
{
    static void Main(string[] args)
    {
        SampleObject root = new SampleObject();

        SampleObject currentObject = root;

        for (int i = 0; i < 10; i++)
        {
            SampleObject o = new SampleObject();

            currentObject.Child = o;

            currentObject = o;
        }
    }
}
Class Program
   
   Public Overloads Shared Sub Main()
      Main(System.Environment.GetCommandLineArgs())
   End Sub
   
   Overloads Shared Sub Main(args() As String)
      Dim root As New SampleObject()
      
      Dim currentObject As SampleObject = root
      
      Dim i As Integer
      For i = 0 To 9
         Dim o As New SampleObject()
         
         currentObject.Child = o
         
         currentObject = o
      Next i
   End Sub 
End Class

Quando root viene serializzato, saranno presenti quattro serializzatori utilizzati: serializzatore di primo uno livello, un serializzatore per l'elemento figlio SampleObject, un serializzatore per inte un serializzatore per string.When root is serialized, there will be four serializers used: one root serializer, one serializer for the child SampleObject, one serializer for int, and one serializer for string. I serializzatori vengono memorizzati nella cache basata su tipo, in modo che non è necessario per creare un serializzatore per ogni istanza di SampleObject.Serializers are cached based on type, so there is no need to create a serializer for each instance of SampleObject.

Il DesignerSerializationManager classe si basa sul concetto di una sessione di serializzazione.The DesignerSerializationManager class is based on the idea of a serialization session. Una sessione mantiene lo stato accessibile dai serializzatori diversi.A session maintains state that can be accessed by the various serializers. Quando viene eliminata una sessione, questo stato viene eliminato definitivamente.When a session is disposed, this state is destroyed. Questa funzionalità garantisce che i serializzatori rimangono in gran parte senza stati e consente di pulire i serializzatori che sono sono danneggiati.This helps to ensure that serializers remain largely stateless, and helps to clean up serializers that are have been corrupted. Le tabelle seguenti descrivono come viene gestito lo stato in e tra le sessioni.The following tables describe how state is managed in and among sessions.

Stato globaleGlobal State

Questo stato è di proprietà dall'oggetto del gestore di serializzazione, ma è indipendente della sessione di serializzazione corrente.This state is owned by the serialization manager object, but is independent of the current serialization session.

ObjectObject UtilizzoUsage
Provider di serializzazioneSerialization providers Gli oggetti possono aggiungere se stessi come provider di serializzazione personalizzata.Objects can add themselves as custom serialization providers. Poiché questi provider vengono usati per individuare i serializzatori, durano più a una sessione di serializzazione.Because these providers are used to locate serializers, they outlive a serialization session.

Stato di sessione-proprietàSession-Owned State

Questo stato è di proprietà di una sessione e viene eliminato quando si elimina una sessione.This state is owned by a session and is destroyed when a session is destroyed. L'accesso a qualsiasi proprietà o metodi che modificano i questo stato di conseguenza, genererà un'eccezione se il gestore della serializzazione non è presente in una sessione attiva.Consequently, accessing any properties or methods that would manipulate this state will throw an exception if the serialization manager is not in an active session.

ObjectObject UtilizzoUsage
EventoResolveName ResolveName event Il ResolveName evento è associato da un serializzatore per fornire aggiuntivi per la risoluzione dei nomi.The ResolveName event is attached by a serializer to provide additional resolution of names. Tutti i gestori vengono scollegati da questo evento quando termina una sessione.All handlers are detached from this event when a session terminates.
EventoSerializationComplete SerializationComplete event Il SerializationComplete evento viene generato appena prima dell'eliminazione di una sessione.The SerializationComplete event is raised just before a session is disposed. Quindi, tutti i gestori vengono scollegati da questo evento.Then, all handlers are detached from this event.
Tabella dei nomiName table Il gestore della serializzazione mantiene una tabella in cui viene eseguito il mapping tra oggetti e i relativi nomi.The serialization manager maintains a table that maps between objects and their names. I serializzatori possono assegnare i nomi degli oggetti per facilitare l'identificazione.Serializers may give objects names for easy identification. Questa tabella dei nomi viene cancellata al termine della sessione.This name table is cleared when the session terminates.
Cache di serializzatoriSerializer cache Il gestore della serializzazione mantiene una cache di serializzatori che è stato chiesto di fornire.The serialization manager maintains a cache of serializers it has been asked to supply. Questa cache viene cancellata al termine della sessione.This cache is cleared when the session terminates. Pubblico GetSerializer metodo può essere chiamato in modo sicuro in qualsiasi momento, ma il relativo valore viene memorizzato nella cache solo se viene chiamato dall'interno di una sessione.The public GetSerializer method can safely be called at any time, but its value is cached only if it is called from within a session.
Stack di contestoContext stack Il gestore della serializzazione gestisce un oggetto denominato lo stack di contesto, che è possibile accedere con il Context proprietà.The serialization manager maintains an object called the context stack, which you can access with the Context property. I serializzatori possono utilizzare questo stack per memorizzare informazioni aggiuntive che sono disponibile per altri serializzatori.Serializers can use this stack to store additional information that is available to other serializers. Ad esempio, un serializzatore che sta eseguendo la serializzazione di un valore della proprietà può inserire il nome della proprietà nello stack di serializzazione prima di richiedere il valore da serializzare.For example, a serializer that is serializing a property value can push the property name on the serialization stack before asking the value to serialize. Questo stack viene cancellato quando la sessione è terminata.This stack is cleared when the session is terminated.
Elenco erroriError list Il gestore della serializzazione mantiene un elenco di errori verificatisi durante la serializzazione.The serialization manager maintains a list of errors that occurred during serialization. Questo elenco, accessibile tramite il Errors proprietà, viene cancellata al termine della sessione.This list, which is accessed through the Errors property, is cleared when the session is terminated. L'accesso al Errors proprietà tra le sessioni genererà un'eccezione.Accessing the Errors property between sessions will result in an exception.

Costruttori

DesignerSerializationManager() DesignerSerializationManager() DesignerSerializationManager() DesignerSerializationManager()

Inizializza una nuova istanza della classe DesignerSerializationManager.Initializes a new instance of the DesignerSerializationManager class.

DesignerSerializationManager(IServiceProvider) DesignerSerializationManager(IServiceProvider) DesignerSerializationManager(IServiceProvider) DesignerSerializationManager(IServiceProvider)

Inizializza una nuova istanza di DesignerSerializationManager classe con il provider di servizi specificato.Initializes a new instance of the DesignerSerializationManager class with the given service provider.

Proprietà

Container Container Container Container

Ottiene o imposta il contenitore per questo gestore della serializzazione.Gets or sets to the container for this serialization manager.

Errors Errors Errors Errors

Ottiene l'elenco di errori verificatisi durante la serializzazione o deserializzazione.Gets the list of errors that occurred during serialization or deserialization.

PreserveNames PreserveNames PreserveNames PreserveNames

Ottiene o imposta un valore che indica se il CreateInstance(Type, ICollection, String, Boolean) metodo dovrebbe verificare la presenza del nome dato nel contenitore.Gets or sets a value indicating whether the CreateInstance(Type, ICollection, String, Boolean) method should check for the presence of the given name in the container.

PropertyProvider PropertyProvider PropertyProvider PropertyProvider

Ottiene l'oggetto che deve essere utilizzato per fornire proprietà del gestore della serializzazione Properties proprietà.Gets the object that should be used to provide properties to the serialization manager's Properties property.

RecycleInstances RecycleInstances RecycleInstances RecycleInstances

Ottiene o imposta un valore che indica se CreateInstance(Type, ICollection, String, Boolean) creerà sempre una nuova istanza di un tipo.Gets or sets a value that indicates whether CreateInstance(Type, ICollection, String, Boolean) will always create a new instance of a type.

ValidateRecycledTypes ValidateRecycledTypes ValidateRecycledTypes ValidateRecycledTypes

Ottiene o imposta un valore che indica se il metodo CreateInstance(Type, ICollection, String, Boolean) verificherà che i nomi corrispondenti facciano riferimento allo stesso tipo.Gets or sets a value that indicates whether the CreateInstance(Type, ICollection, String, Boolean) method will verify that matching names refer to the same type.

Metodi

CreateInstance(Type, ICollection, String, Boolean) CreateInstance(Type, ICollection, String, Boolean) CreateInstance(Type, ICollection, String, Boolean) CreateInstance(Type, ICollection, String, Boolean)

Crea un'istanza di un tipo.Creates an instance of a type.

CreateSession() CreateSession() CreateSession() CreateSession()

Crea una nuova sessione di serializzazione.Creates a new serialization session.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetRuntimeType(String) GetRuntimeType(String) GetRuntimeType(String) GetRuntimeType(String)

Ottiene il tipo corrispondente al nome del tipo specificato.Gets the type corresponding to the specified type name.

GetSerializer(Type, Type) GetSerializer(Type, Type) GetSerializer(Type, Type) GetSerializer(Type, Type)

Ottiene il serializzatore per il tipo di oggetto specificato.Gets the serializer for the given object type.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Ottiene il servizio richiesto.Gets the requested service.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetType(String) GetType(String) GetType(String) GetType(String)

Ottiene il tipo richiesto.Gets the requested type.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnResolveName(ResolveNameEventArgs) OnResolveName(ResolveNameEventArgs) OnResolveName(ResolveNameEventArgs) OnResolveName(ResolveNameEventArgs)

Genera l'evento ResolveName.Raises the ResolveName event.

OnSessionCreated(EventArgs) OnSessionCreated(EventArgs) OnSessionCreated(EventArgs) OnSessionCreated(EventArgs)

Genera l'evento SessionCreated.Raises the SessionCreated event.

OnSessionDisposed(EventArgs) OnSessionDisposed(EventArgs) OnSessionDisposed(EventArgs) OnSessionDisposed(EventArgs)

Genera l'evento SessionDisposed.Raises the SessionDisposed event.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Eventi

SessionCreated SessionCreated SessionCreated SessionCreated

Si verifica quando viene creata una sessione.Occurs when a session is created.

SessionDisposed SessionDisposed SessionDisposed SessionDisposed

Si verifica quando viene eliminata una sessione.Occurs when a session is disposed.

Implementazioni dell'interfaccia esplicita

IDesignerSerializationManager.AddSerializationProvider(IDesignerSerializationProvider) IDesignerSerializationManager.AddSerializationProvider(IDesignerSerializationProvider) IDesignerSerializationManager.AddSerializationProvider(IDesignerSerializationProvider) IDesignerSerializationManager.AddSerializationProvider(IDesignerSerializationProvider)

Aggiunge un provider di serializzazione personalizzato al gestore della serializzazione.Adds a custom serialization provider to the serialization manager.

IDesignerSerializationManager.Context IDesignerSerializationManager.Context IDesignerSerializationManager.Context IDesignerSerializationManager.Context

Ottiene lo stack di contesto per questa sessione di serializzazione.Gets the context stack for this serialization session.

IDesignerSerializationManager.CreateInstance(Type, ICollection, String, Boolean) IDesignerSerializationManager.CreateInstance(Type, ICollection, String, Boolean) IDesignerSerializationManager.CreateInstance(Type, ICollection, String, Boolean) IDesignerSerializationManager.CreateInstance(Type, ICollection, String, Boolean)

Implementa il metodo CreateInstance(Type, ICollection, String, Boolean).Implements the CreateInstance(Type, ICollection, String, Boolean) method.

IDesignerSerializationManager.GetInstance(String) IDesignerSerializationManager.GetInstance(String) IDesignerSerializationManager.GetInstance(String) IDesignerSerializationManager.GetInstance(String)

Recupera un'istanza di un oggetto creato con il nome specificato.Retrieves an instance of a created object of the specified name.

IDesignerSerializationManager.GetName(Object) IDesignerSerializationManager.GetName(Object) IDesignerSerializationManager.GetName(Object) IDesignerSerializationManager.GetName(Object)

Recupera un nome per l'oggetto specificato.Retrieves a name for the specified object.

IDesignerSerializationManager.GetSerializer(Type, Type) IDesignerSerializationManager.GetSerializer(Type, Type) IDesignerSerializationManager.GetSerializer(Type, Type) IDesignerSerializationManager.GetSerializer(Type, Type)

Ottiene un serializzatore del tipo richiesto per il tipo di oggetto specificato.Gets a serializer of the requested type for the specified object type.

IDesignerSerializationManager.GetType(String) IDesignerSerializationManager.GetType(String) IDesignerSerializationManager.GetType(String) IDesignerSerializationManager.GetType(String)

Ottiene un tipo il nome specificato.Gets a type of the specified name.

IDesignerSerializationManager.Properties IDesignerSerializationManager.Properties IDesignerSerializationManager.Properties IDesignerSerializationManager.Properties

Implementa il Properties proprietà.Implements the Properties property.

IDesignerSerializationManager.RemoveSerializationProvider(IDesignerSerializationProvider) IDesignerSerializationManager.RemoveSerializationProvider(IDesignerSerializationProvider) IDesignerSerializationManager.RemoveSerializationProvider(IDesignerSerializationProvider) IDesignerSerializationManager.RemoveSerializationProvider(IDesignerSerializationProvider)

Rimuove un provider di serializzazione aggiunto in precedenza.Removes a previously added serialization provider.

IDesignerSerializationManager.ReportError(Object) IDesignerSerializationManager.ReportError(Object) IDesignerSerializationManager.ReportError(Object) IDesignerSerializationManager.ReportError(Object)

Utilizzato per segnalare un errore risolvibile nella serializzazione.Used to report a recoverable error in serialization.

IDesignerSerializationManager.ResolveName IDesignerSerializationManager.ResolveName IDesignerSerializationManager.ResolveName IDesignerSerializationManager.ResolveName

Viene generato quando il metodo IDesignerSerializationManager.GetName(Object) non è in grado di individuare il nome specificato nella tabella dei nomi del gestore della serializzazione.Occurs when IDesignerSerializationManager.GetName(Object) cannot locate the specified name in the serialization manager's name table.

IDesignerSerializationManager.SerializationComplete IDesignerSerializationManager.SerializationComplete IDesignerSerializationManager.SerializationComplete IDesignerSerializationManager.SerializationComplete

Viene generato al termine della serializzazione.Occurs when serialization is complete.

IDesignerSerializationManager.SetName(Object, String) IDesignerSerializationManager.SetName(Object, String) IDesignerSerializationManager.SetName(Object, String) IDesignerSerializationManager.SetName(Object, String)

Imposta il nome per l'oggetto specificato.Sets the name for the specified object.

IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type)

Per una descrizione di questo membro, vedere il metodo GetService(Type).For a description of this member, see the GetService(Type) method.

Si applica a

Vedi anche