DesignerSerializationManager Třída

Definice

Poskytuje implementaci IDesignerSerializationManager rozhraní.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
Dědičnost
DesignerSerializationManager
Implementuje

Poznámky

IDesignerSerializationManagerRozhraní je navrženo jako rozhraní nezávislé na formátu pro objekt, který ovládá serializaci.The IDesignerSerializationManager interface is designed to be a format-independent interface to an object that controls serialization. V podstatě poskytuje kontext a služby serializátorům, které ve skutečnosti provádí deserializaci.It essentially provides context and services to serializers, which actually perform the deserialization. IDesignerSerializationManager pomáhá v procesu deserializace tím, že udržuje přehled o objektech.IDesignerSerializationManager assists in the deserialization process by keeping track of objects. To je podobné jako u IDesignerHost rozhraní: návrháři skutečně poskytují uživatelské rozhraní (UI) a IDesignerHost poskytují připevnění, které umožňuje vzájemnou spolupráci různých návrhářů.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.

DesignerSerializationManagerTřída implementuje IDesignerSerializationManager .The DesignerSerializationManager class implements IDesignerSerializationManager. Je navržena tak, aby poskytovala obecnou formu deserializace, která je podobná serializátorům run-time, jako je BinaryFormatter .It is designed to provide a generic form of deserialization that is similar to run-time serializers like the BinaryFormatter.

DesignerSerializationManagerTřída dosahuje tří cílů:The DesignerSerializationManager class achieves three goals:

  • Je to jednoduchý objekt klíč, který lze použít k rekonstrukci nejrůznějších formátů.It is a simple, turnkey object that can be used to deserialize a variety of formats.

  • Je obecný a není svázán s žádným konkrétním formátem.It is generic and not tied to any particular format. Dá se použít stejně pro deserializaci CodeDOM a také jako deserializaci značek.It can be used equally for CodeDOM deserialization as well as markup deserialization.

  • Je rozšiřitelná a podporuje různé metody serializace, které se používají ve scénářích kopírování, vkládání a vrácení zpět a opakování.It is extensible and supports different serialization methods that are used in copy/paste and undo/redo scenarios.

Serializace v době návrhu má následující rozdíly oproti serializaci objektů za běhu:Design-time serialization has the following differences from run-time object serialization:

  • Objekt, který provádí serializaci, je obecně oddělený od objektu run-time, aby bylo možné odebrat logiku návrhového času ze součásti.The object performing the serialization is generally separate from the run-time object, so that design-time logic can be removed from a component.

  • Schéma serializace předpokládá, že se objekt vytvoří plně inicializovaný a pak se během deserializace upraví prostřednictvím vlastností a volání metod.The serialization scheme assumes the object will be created fully initialized, and then modified through property and method invocations during deserialization.

  • Vlastnosti objektu, které mají hodnoty, které nebyly nastaveny pro objekt (vlastnosti obsahují výchozí hodnoty) nejsou serializovány.Properties of an object that have values that were never set on the object (the properties contain the default values) are not serialized. Naopak datový proud deserializace může mít díry.Conversely, the deserialization stream may have holes.

  • Důrazně je kladen na kvalitu obsahu v rámci datového proudu serializace namísto úplné serializace objektu.Emphasis is placed on the quality of the content within the serialization stream, rather than the full serialization of an object. To znamená, že pokud neexistuje žádný definovaný způsob serializace objektu, může být tento objekt vynechán namísto vyvolání výjimky.This means that if there is no defined way to serialize an object, that object may be skipped rather than throwing an exception. Serializační modul může tady poskytnout heuristické účely rozhodování o tom, které chyby je možné ignorovat a které jsou neobnovitelné.The serialization engine may provide heuristics here to decide which failures can be ignored and which are unrecoverable.

  • Datový proud serializace může mít více dat, než je nutné pro deserializaci.The serialization stream may have more data than is needed for deserialization. Serializace zdrojového kódu například obsahuje kód uživatele v kombinaci s kódem potřebným k deserializaci grafu objektů.Source code serialization, for example, has user code mixed in with the code needed to deserialize an object graph. Tento uživatelský kód musí být ignorován při deserializaci a zachován při serializaci.This user code must be ignored on deserialization and preserved on serialization.

Z důvodu těchto rozdílů se pro serializaci v době návrhu používá jiný model serializace.Because of these differences, a different serialization model applies to design-time serialization. Tento model využívá samostatný objekt serializátoru pro každý serializovaný datový typ.This model utilizes a separate serializer object for each data type being serialized. Každý serializátor poskytuje svůj malý příspěvek k problému jako celku.Each serializer provides its small contribution to the problem as a whole. Tyto serializace jsou všechny koordinovány prostřednictvím společného správce serializace.These serializers are all coordinated through a common serialization manager. Správce serializace zodpovídá za zachování stavu mezi těmito různými serializátory.The serialization manager is responsible for maintaining state between these different serializers. Zvažte například následující třídu: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 

Instance této třídy by využila tři různé serializátory: jeden pro SampleObject , jeden pro řetězce a druhý pro celá čísla.An instance of this class would utilize three different serializers: one for SampleObject, one for strings, and another for integers. Serializátor pro SampleObject se nazývá kořenový serializátor, protože SampleObject je kořenem grafu serializace.The serializer for SampleObject is called the root serializer because SampleObject is the root of the serialization graph. Lze také vytvořit složitější grafy objektů.More complex object graphs can be created as well. Například zvažte, co se stane, pokud SampleObject bylo změněno následujícím způsobem: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 

To umožňuje SampleObject mít podřízenou položku, která je jinou instancí sebe sama.This allows SampleObject to have a child that is another instance of itself. Následující kód vyplní v grafu objektů: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

Při root serializaci budou použity čtyři serializátory: jeden kořenový serializátor, jeden serializátor pro podřízený SampleObject , jeden serializátor pro int a jeden serializátor pro 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. Serializátory jsou uloženy v mezipaměti na základě typu, takže není nutné vytvářet serializátor pro každou instanci třídy SampleObject .Serializers are cached based on type, so there is no need to create a serializer for each instance of SampleObject.

DesignerSerializationManagerTřída je založena na nápadu relace serializace.The DesignerSerializationManager class is based on the idea of a serialization session. Relace udržuje stav, který je možné použít v různých serializátorech.A session maintains state that can be accessed by the various serializers. Když je relace vyřazena, je tento stav zničen.When a session is disposed, this state is destroyed. To pomáhá zajistit, aby serializátory zůstaly ve značné míře bez stavů, a pomáhají vyčistit serializátory, které jsou poškozené.This helps to ensure that serializers remain largely stateless, and helps to clean up serializers that are have been corrupted. Následující tabulky popisují, jak je stav spravován v a mezi relacemi.The following tables describe how state is managed in and among sessions.

Globální stavGlobal State

Tento stav je vlastněn objektem správce serializace, ale je nezávisle na aktuální relaci serializace.This state is owned by the serialization manager object, but is independent of the current serialization session.

ObjektObject VyužitíUsage
Zprostředkovatelé serializaceSerialization providers Objekty mohou být přidány jako vlastní zprostředkovatelé serializace.Objects can add themselves as custom serialization providers. Vzhledem k tomu, že se tito poskytovatelé používají k vyhledání serializátorů, vycházejí z nich relaci serializace.Because these providers are used to locate serializers, they outlive a serialization session.

Session-Owned stavSession-Owned State

Tento stav je vlastněn relací a je zničen při zničení relace.This state is owned by a session and is destroyed when a session is destroyed. V důsledku toho se přístup k jakýmkoli vlastnostem nebo metodám, které by mohly manipulovat s tímto stavem, vyvolá výjimku, pokud správce serializace není v aktivní relaci.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.

ObjektObject VyužitíUsage
ResolveName událostíResolveName event ResolveNameUdálost je připojena serializátorem k poskytnutí dalšího rozlišení názvů.The ResolveName event is attached by a serializer to provide additional resolution of names. Všechny obslužné rutiny jsou od ukončení relace odpojeny od této události.All handlers are detached from this event when a session terminates.
SerializationComplete událostíSerializationComplete event SerializationCompleteUdálost je vyvolána těsně před uvolněním relace.The SerializationComplete event is raised just before a session is disposed. Pak jsou všechny obslužné rutiny odpojeny od této události.Then, all handlers are detached from this event.
Tabulka názvůName table Správce serializace udržuje tabulku, která je mapována mezi objekty a jejich názvy.The serialization manager maintains a table that maps between objects and their names. Serializátory můžou poskytovat názvy objektů pro snadnější identifikaci.Serializers may give objects names for easy identification. Tato tabulka názvů se po ukončení relace vymaže.This name table is cleared when the session terminates.
Mezipaměť serializátoruSerializer cache Správce serializace udržuje mezipaměť serializátorů, která byla požádána o poskytnutí.The serialization manager maintains a cache of serializers it has been asked to supply. Tato mezipaměť je vymazána při ukončení relace.This cache is cleared when the session terminates. Veřejnou GetSerializer metodu lze bezpečně volat kdykoli, ale její hodnota je uložena do mezipaměti pouze v případě, že je volána v rámci relace.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.
Zásobník kontextuContext stack Správce serializace udržuje objekt nazvaný zásobník kontextu, ke kterému můžete přistupovat pomocí Context Vlastnosti.The serialization manager maintains an object called the context stack, which you can access with the Context property. Serializátory můžou pomocí tohoto zásobníku ukládat Další informace, které jsou k dispozici jiným serializátorům.Serializers can use this stack to store additional information that is available to other serializers. Například serializátor, který provádí serializaci hodnoty vlastnosti, může před položením hodnoty k serializaci vložit název vlastnosti v zásobníku serializace.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. Tento zásobník je po ukončení relace vymazán.This stack is cleared when the session is terminated.
Seznam chybError list Správce serializace udržuje seznam chyb, ke kterým došlo během serializace.The serialization manager maintains a list of errors that occurred during serialization. Tento seznam, který je k dispozici prostřednictvím Errors vlastnosti, je při ukončení relace vymazán.This list, which is accessed through the Errors property, is cleared when the session is terminated. Přístup k Errors vlastnosti mezi relacemi bude mít za následek výjimku.Accessing the Errors property between sessions will result in an exception.

Konstruktory

DesignerSerializationManager()

Inicializuje novou instanci DesignerSerializationManager třídy.Initializes a new instance of the DesignerSerializationManager class.

DesignerSerializationManager(IServiceProvider)

Inicializuje novou instanci DesignerSerializationManager třídy s daným poskytovatelem služeb.Initializes a new instance of the DesignerSerializationManager class with the given service provider.

Vlastnosti

Container

Získá nebo nastaví kontejner pro tohoto správce serializace.Gets or sets to the container for this serialization manager.

Errors

Získá seznam chyb, ke kterým došlo při serializaci nebo deserializaci.Gets the list of errors that occurred during serialization or deserialization.

PreserveNames

Získává nebo nastavuje hodnotu, která označuje, jestli má CreateInstance(Type, ICollection, String, Boolean) Metoda kontrolovat přítomnost daného názvu v kontejneru.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

Získá objekt, který by měl být použit k poskytnutí vlastností vlastnosti správce serializace Properties .Gets the object that should be used to provide properties to the serialization manager's Properties property.

RecycleInstances

Získává nebo nastavuje hodnotu, která indikuje, jestli CreateInstance(Type, ICollection, String, Boolean) se má vždycky vytvořit nová instance typu.Gets or sets a value that indicates whether CreateInstance(Type, ICollection, String, Boolean) will always create a new instance of a type.

ValidateRecycledTypes

Získává nebo nastavuje hodnotu, která indikuje, jestli CreateInstance(Type, ICollection, String, Boolean) Metoda ověří, jestli se odpovídající názvy odkazují na stejný typ.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.

Metody

CreateInstance(Type, ICollection, String, Boolean)

Vytvoří instanci typu.Creates an instance of a type.

CreateSession()

Vytvoří novou relaci serializace.Creates a new serialization session.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetRuntimeType(String)

Získá typ odpovídající zadanému názvu typu.Gets the type corresponding to the specified type name.

GetSerializer(Type, Type)

Získá serializátor pro daný typ objektu.Gets the serializer for the given object type.

GetService(Type)

Získá požadovanou službu.Gets the requested service.

GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
GetType(String)

Získá požadovaný typ.Gets the requested type.

MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
OnResolveName(ResolveNameEventArgs)

Vyvolá ResolveName událost.Raises the ResolveName event.

OnSessionCreated(EventArgs)

Vyvolá SessionCreated událost.Raises the SessionCreated event.

OnSessionDisposed(EventArgs)

Vyvolá SessionDisposed událost.Raises the SessionDisposed event.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Události

SessionCreated

Vyvolá se při vytvoření relace.Occurs when a session is created.

SessionDisposed

Vyvolá se v případě, že dojde k odstranění relace.Occurs when a session is disposed.

Explicitní implementace rozhraní

IDesignerSerializationManager.AddSerializationProvider(IDesignerSerializationProvider)

Přidá vlastního zprostředkovatele serializace do správce serializace.Adds a custom serialization provider to the serialization manager.

IDesignerSerializationManager.Context

Získá zásobník kontextu pro tuto relaci serializace.Gets the context stack for this serialization session.

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

Implementuje CreateInstance(Type, ICollection, String, Boolean) metodu.Implements the CreateInstance(Type, ICollection, String, Boolean) method.

IDesignerSerializationManager.GetInstance(String)

Načte instanci vytvořeného objektu se zadaným názvem.Retrieves an instance of a created object of the specified name.

IDesignerSerializationManager.GetName(Object)

Načte název zadaného objektu.Retrieves a name for the specified object.

IDesignerSerializationManager.GetSerializer(Type, Type)

Získá serializátor požadovaného typu pro zadaný typ objektu.Gets a serializer of the requested type for the specified object type.

IDesignerSerializationManager.GetType(String)

Získá typ zadaného názvu.Gets a type of the specified name.

IDesignerSerializationManager.Properties

Implementuje Properties vlastnost.Implements the Properties property.

IDesignerSerializationManager.RemoveSerializationProvider(IDesignerSerializationProvider)

Odebere dříve přidaný zprostředkovatel serializace.Removes a previously added serialization provider.

IDesignerSerializationManager.ReportError(Object)

Slouží k hlášení obnovitelné chyby v serializaci.Used to report a recoverable error in serialization.

IDesignerSerializationManager.ResolveName

Nastane, pokud IDesignerSerializationManager.GetName(Object) nemůže najít zadaný název v tabulce názvů správce serializace.Occurs when IDesignerSerializationManager.GetName(Object) cannot locate the specified name in the serialization manager's name table.

IDesignerSerializationManager.SerializationComplete

Vyvolá se v případě, že je serializace dokončena.Occurs when serialization is complete.

IDesignerSerializationManager.SetName(Object, String)

Nastaví název zadaného objektu.Sets the name for the specified object.

IServiceProvider.GetService(Type)

Popis tohoto člena naleznete v GetService(Type) metodě.For a description of this member, see the GetService(Type) method.

Platí pro

Viz také