IDesignerSerializationManager インターフェイス

リファレンス

定義

名前空間:: System.ComponentModel.Design.Serialization

アセンブリ:: System.ComponentModel.TypeConverter.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

デザイン時のシリアル化を管理するためのインターフェイスを提供します。

public interface class IDesignerSerializationManager : IServiceProvider

public interface IDesignerSerializationManager : IServiceProvider

type IDesignerSerializationManager = interface
    interface IServiceProvider

Public Interface IDesignerSerializationManager
Implements IServiceProvider

派生: System.ComponentModel.Design.Serialization.DesignerSerializationManager

System.Workflow.ComponentModel.Serialization.ActivityCodeDomSerializationManager

System.Workflow.ComponentModel.Serialization.WorkflowMarkupSerializationManager

実装: IServiceProvider

例

次の例は、を使用 IDesignerSerializationManager して Code DOM ステートメントをシリアル化および逆シリアル化する方法を示しています。

#using <System.Drawing.dll>
#using <System.dll>
#using <System.Design.dll>

using namespace System;
using namespace System::CodeDom;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::ComponentModel::Design::Serialization;
using namespace System::Drawing;
using namespace System::Windows::Forms;

namespace CodeDomSerializerSample
{
   ref class MyComponent;
   private ref class MyCodeDomSerializer: public CodeDomSerializer
   {
   public:
      Object^ Deserialize( IDesignerSerializationManager^ manager, Object^ codeObject ) new
      {
         // This is how we associate the component with the serializer.
         CodeDomSerializer^ baseClassSerializer = (CodeDomSerializer^)(
            manager->GetSerializer(
               MyComponent::typeid->BaseType, CodeDomSerializer::typeid ));
         
         /* This is the simplest case, in which the class just calls the base class
            to do the work. */
         return baseClassSerializer->Deserialize( manager, codeObject );
      }

      Object^ Serialize( IDesignerSerializationManager^ manager, Object^ value ) new
      {
         /* Associate the component with the serializer in the same manner as with
            Deserialize */
         CodeDomSerializer^ baseClassSerializer = (CodeDomSerializer^)(
            manager->GetSerializer(
               MyComponent::typeid->BaseType, CodeDomSerializer::typeid ));

         Object^ codeObject = baseClassSerializer->Serialize( manager, value );
         
         /* Anything could be in the codeObject.  This sample operates on a
            CodeStatementCollection. */
         if ( (CodeStatementCollection^)(codeObject) )
         {
            CodeStatementCollection^ statements = (CodeStatementCollection^)(codeObject);
            
            // The code statement collection is valid, so add a comment.
            String^ commentText = "This comment was added to this object by a custom serializer.";
            CodeCommentStatement^ comment = gcnew CodeCommentStatement( commentText );
            statements->Insert( 0, comment );
         }
         return codeObject;
      }
   };

   [DesignerSerializer(CodeDomSerializerSample::MyCodeDomSerializer::typeid,
      CodeDomSerializer::typeid)]
   public ref class MyComponent: public Component
   {
   private:
      String^ localProperty;

   public:
      MyComponent()
      {
         localProperty = "Component Property Value";
      }

      property String^ LocalProperty 
      {
         String^ get()
         {
            return localProperty;
         }
         void set( String^ value )
         {
            localProperty = value;
         }
      }
   };
}

using System;
using System.CodeDom;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.ComponentModel.Design.Serialization;
using System.Drawing;
using System.Windows.Forms;
 
namespace CodeDomSerializerSample
{
    internal class MyCodeDomSerializer : CodeDomSerializer {
        public override object Deserialize(IDesignerSerializationManager manager, object codeObject) {
            // This is how we associate the component with the serializer.
                CodeDomSerializer baseClassSerializer = (CodeDomSerializer)manager.
                GetSerializer(typeof(MyComponent).BaseType, typeof(CodeDomSerializer));

            /* This is the simplest case, in which the class just calls the base class
                to do the work. */
            return baseClassSerializer.Deserialize(manager, codeObject);
        }
 
        public override object Serialize(IDesignerSerializationManager manager, object value) {
            /* Associate the component with the serializer in the same manner as with
                Deserialize */
            CodeDomSerializer baseClassSerializer = (CodeDomSerializer)manager.
                GetSerializer(typeof(MyComponent).BaseType, typeof(CodeDomSerializer));
 
            object codeObject = baseClassSerializer.Serialize(manager, value);
 
            /* Anything could be in the codeObject.  This sample operates on a
                CodeStatementCollection. */
            if (codeObject is CodeStatementCollection) {
                CodeStatementCollection statements = (CodeStatementCollection)codeObject;
 
                // The code statement collection is valid, so add a comment.
                string commentText = "This comment was added to this object by a custom serializer.";
                CodeCommentStatement comment = new CodeCommentStatement(commentText);
                statements.Insert(0, comment);
            }
            return codeObject;
        }
    }
 
    [DesignerSerializer(typeof(MyCodeDomSerializer), typeof(CodeDomSerializer))]
    public class MyComponent : Component {
        private string localProperty = "Component Property Value";
        public string LocalProperty {
            get {
                return localProperty;
            }
            set {
                localProperty = value;
            }
        }
    }
}

Imports System.CodeDom
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.ComponentModel.Design.Serialization
Imports System.Drawing
Imports System.Windows.Forms

Namespace CodeDomSerializerSample
   Friend Class MyCodeDomSerializer
      Inherits CodeDomSerializer

      Public Overrides Function Deserialize(ByVal manager As IDesignerSerializationManager, _
                                                ByVal codeObject As Object) As Object
         ' This is how we associate the component with the serializer.
         Dim baseClassSerializer As CodeDomSerializer = CType(manager.GetSerializer( _
                GetType(MyComponent).BaseType, GetType(CodeDomSerializer)), CodeDomSerializer)

         ' This is the simplest case, in which the class just calls the base class
         '  to do the work. 
         Return baseClassSerializer.Deserialize(manager, codeObject)
      End Function 'Deserialize

      Public Overrides Function Serialize(ByVal manager As IDesignerSerializationManager, _
                                            ByVal value As Object) As Object
         ' Associate the component with the serializer in the same manner as with
         '  Deserialize
         Dim baseClassSerializer As CodeDomSerializer = CType(manager.GetSerializer( _
                GetType(MyComponent).BaseType, GetType(CodeDomSerializer)), CodeDomSerializer)

         Dim codeObject As Object = baseClassSerializer.Serialize(manager, value)

         ' Anything could be in the codeObject.  This sample operates on a
         '  CodeStatementCollection.
         If TypeOf codeObject Is CodeStatementCollection Then
            Dim statements As CodeStatementCollection = CType(codeObject, CodeStatementCollection)

            ' The code statement collection is valid, so add a comment.
            Dim commentText As String = "This comment was added to this object by a custom serializer."
            Dim comment As New CodeCommentStatement(commentText)
            statements.Insert(0, comment)
         End If
         Return codeObject
      End Function 'Serialize
   End Class

   <DesignerSerializer(GetType(MyCodeDomSerializer), GetType(CodeDomSerializer))> _
   Public Class MyComponent
      Inherits Component
      Private localProperty As String = "Component Property Value"

      Public Property LocalProp() As String
         Get
            Return localProperty
         End Get
         Set(ByVal Value As String)
            localProperty = Value
         End Set
      End Property
   End Class

End Namespace

注釈

デザイナーは、デザイン時のシリアル化プロセスの管理に役立つサービスにアクセスするために利用 IDesignerSerializationManager できます。たとえば、デザイナーのシリアル化マネージャーを実装するクラスは、このインターフェイスを使用して、オブジェクトの作成、型の検索、オブジェクトの識別、特定の型のシリアル化のカスタマイズを行うことができます。

プロパティ

Context	シリアライザー間の通信に役立つスタックベースのユーザー定義ストレージエリアを取得します。
Properties	有効なシリアライザーを使用してシリアル化できるカスタムプロパティを示します。

メソッド

AddSerializationProvider(IDesignerSerializationProvider)	指定したシリアル化プロバイダーをシリアル化マネージャーに追加します。
CreateInstance(Type, ICollection, String, Boolean)	指定した型のインスタンスを作成し、作成したインスタンスを名前付きインスタンスのコレクションに追加します。
GetInstance(String)	指定した名前で作成されたオブジェクトのインスタンスを取得します。そのようなオブジェクトが存在しない場合は `null` を取得します。
GetName(Object)	指定したオブジェクトの名前を取得します。オブジェクトに名前がない場合は `null` を取得します。
GetSerializer(Type, Type)	指定したオブジェクト型に対応する、要求された型のシリアライザーを取得します。
GetService(Type)	指定した型のサービスオブジェクトを取得します。 (継承元 IServiceProvider)
GetType(String)	指定した名前の型を取得します。
RemoveSerializationProvider(IDesignerSerializationProvider)	カスタムシリアル化プロバイダーをシリアル化マネージャーから削除します。
ReportError(Object)	シリアル化時のエラーを報告します。
SetName(Object, String)	指定した既存のオブジェクトの名前を設定します。

イベント

ResolveName	GetName(Object) が、指定した名前をシリアル化マネージャーの名前テーブルで見つけることができない場合に発生します。
SerializationComplete	シリアル化が完了したときに発生します。

拡張メソッド

GetKeyedService<T>(IServiceProvider, Object)	から型 `T` のサービスを取得します IServiceProvider。
GetKeyedServices(IServiceProvider, Type, Object)	から型 `serviceType` のサービスの列挙体を取得します IServiceProvider。
GetKeyedServices<T>(IServiceProvider, Object)	から型 `T` のサービスの列挙体を取得します IServiceProvider。
GetRequiredKeyedService(IServiceProvider, Type, Object)	から型 `serviceType` のサービスを取得します IServiceProvider。
GetRequiredKeyedService<T>(IServiceProvider, Object)	から型 `T` のサービスを取得します IServiceProvider。
CreateAsyncScope(IServiceProvider)	スコープサービスを解決するために使用できる新しい AsyncServiceScope を作成します。
CreateScope(IServiceProvider)	スコープサービスを解決するために使用できる新しい IServiceScope を作成します。
GetRequiredService(IServiceProvider, Type)	IServiceProvider から `serviceType` 型のサービスを取得します。
GetRequiredService<T>(IServiceProvider)	IServiceProvider から `T` 型のサービスを取得します。
GetService<T>(IServiceProvider)	IServiceProvider から `T` 型のサービスを取得します。
GetServices(IServiceProvider, Type)	IServiceProvider から `serviceType` 型のサービスの列挙体を取得します。
GetServices<T>(IServiceProvider)	IServiceProvider から `T` 型のサービスの列挙体を取得します。
GetFakeLogCollector(IServiceProvider)	偽のロガーに送信されたログレコードを収集するオブジェクトを取得します。
GetFakeRedactionCollector(IServiceProvider)	依存関係挿入コンテナーから偽の redactor コレクターインスタンスを取得します。

適用対象

製品	バージョン
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

こちらもご覧ください

IServiceProvider

次の方法で共有