DesignerSerializationManager Класс

Определение

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

Наследование

Object

DesignerSerializationManager

Реализации

IDesignerSerializationManager IServiceProvider

Комментарии

Интерфейс IDesignerSerializationManager разработан как независимый от формата интерфейс для объекта, управляющего сериализацией. По сути, он предоставляет контекст и службы сериализаторам, которые фактически выполняют десериализацию. IDesignerSerializationManager помогает в процессе десериализации, отслеживая объекты . Этот метод аналогичен интерфейсу IDesignerHost : конструкторы фактически предоставляют пользовательский интерфейс и IDesignerHost обеспечивают клей, позволяющий различным конструкторам работать вместе.

Класс DesignerSerializationManager реализует IDesignerSerializationManager. Он предназначен для предоставления универсальной формы десериализации, аналогичной сериализаторам времени выполнения, таким как BinaryFormatter.

Класс DesignerSerializationManager достигает трех целей:

• Это простой готовый объект, который можно использовать для десериализации различных форматов.

• Он является универсальным и не привязан к какому-либо конкретному формату. Его можно в равной степени использовать для десериализации CodeDOM, а также для десериализации разметки.

• Он является расширяемым и поддерживает различные методы сериализации, которые используются в сценариях копирования, вставки и отмены и повтора.

Сериализация во время разработки имеет следующие отличия от сериализации объектов во время выполнения.

• Объект, выполняющий сериализацию, обычно отделен от объекта времени выполнения, поэтому логику времени разработки можно удалить из компонента.

• Схема сериализации предполагает, что объект будет создан полностью инициализирован, а затем изменен с помощью вызовов свойств и методов во время десериализации.

• Свойства объекта со значениями, которые никогда не были заданы для объекта (свойства содержат значения по умолчанию), не сериализуются. И наоборот, поток десериализации может иметь отверстия.

• Акцент делается на качестве содержимого в потоке сериализации, а не на полной сериализации объекта. Это означает, что если нет определенного способа сериализации объекта, этот объект может быть пропущен вместо создания исключения. Подсистема сериализации может предоставить эвристические методы, чтобы решить, какие сбои можно игнорировать, а какие — неустранимые.

• Поток сериализации может содержать больше данных, чем требуется для десериализации. Например, в сериализации исходного кода пользовательский код смешивается с кодом, необходимым для десериализации графа объектов. Этот пользовательский код должен быть проигнорирован при десериализации и сохранен при сериализации.

Из-за этих различий к сериализации во время разработки применяется другая модель сериализации. Эта модель использует отдельный объект сериализатора для каждого сериализуемого типа данных. Каждый сериализатор вносит свой небольшой вклад в проблему в целом. Все эти сериализаторы координируются через общий диспетчер сериализации. Диспетчер сериализации отвечает за поддержание состояния между этими разными сериализаторами. В качестве примера рассмотрим следующий класс:

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

Экземпляр этого класса будет использовать три разных сериализатора: один для SampleObject, один для строк, а другой для целых чисел. Сериализатор для SampleObject называется корневым сериализатором, так как SampleObject является корнем графа сериализации. Можно также создавать более сложные графы объектов. Например, рассмотрим, что произойдет, если SampleObject были изменены, следующим образом:

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

Это позволяет SampleObject иметь дочерний элемент, который является другим экземпляром самого себя. Следующий код заполняет граф объектов:

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

При root сериализации используется четыре сериализатора: один корневой сериализатор, один сериализатор для дочернего SampleObject, один сериализатор для intи один сериализатор для string. Сериализаторы кэшируются на основе типа , поэтому нет необходимости создавать сериализатор для каждого экземпляра SampleObject.

Класс DesignerSerializationManager основан на идее сеанса сериализации. Сеанс поддерживает состояние, к которому могут обращаться различные сериализаторы. При удалении сеанса это состояние уничтожается. Это помогает гарантировать, что сериализаторы остаются в значительной степени без отслеживания состояния, и помогает очистить сериализаторы, которые были повреждены. В следующих таблицах описывается управление состоянием в сеансах и между ними.

Глобальное состояние

Это состояние принадлежит объекту диспетчера сериализации, но не зависит от текущего сеанса сериализации.

Состояние Session-Owned

Это состояние принадлежит сеансу и уничтожается при уничтожении сеанса. Следовательно, доступ к любым свойствам или методам, которые будут управлять этим состоянием, вызовет исключение, если диспетчер сериализации не находится в активном сеансе.

Конструкторы

Свойства

Методы

События

Явные реализации интерфейса

Применяется к

См. также раздел

• IDesignerSerializationManager
• IDesignerHost
• ContextStack
• IServiceProvider