DesignerSerializationVisibilityAttribute クラス

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.Primitives.dll

ソース:

DesignerSerializationVisibilityAttribute.cs

デザイン時にコンポーネントのプロパティをシリアル化するときに使用する永続化の種類を指定します。

public ref class DesignerSerializationVisibilityAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Event | System.AttributeTargets.Field | System.AttributeTargets.Method | System.AttributeTargets.Property)]
public sealed class DesignerSerializationVisibilityAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Event | System.AttributeTargets.Field | System.AttributeTargets.Method | System.AttributeTargets.Property)>]
type DesignerSerializationVisibilityAttribute = class
    inherit Attribute

Public NotInheritable Class DesignerSerializationVisibilityAttribute
Inherits Attribute

継承

Object

Attribute

DesignerSerializationVisibilityAttribute

属性

AttributeUsageAttribute

例

次のコード例では、 セットを に使用する方法をDesignerSerializationVisibilityAttributeContent示します。 ユーザー コントロールのパブリック プロパティの値が保持され、デザイン時に構成できます。 この例を使用するには、最初に次のコードをユーザー コントロール ライブラリにコンパイルします。 次に、コンパイルされた .dll ファイルへの参照を新しい Windows アプリケーション プロジェクトに追加します。 Visual Studio を使用している場合は、 ContentSerializationExampleControl が自動的に ツールボックスに追加されます。

ツールボックスからフォームにコントロールをドラッグし、プロパティ ウィンドウに一覧表示されているオブジェクトのDimensionDataプロパティを設定します。 フォームのコードを表示すると、コードが親フォームの メソッドに InitializeComponent 追加されます。 このコードでは、コントロールのプロパティの値をデザイン モードで設定した値に設定します。

#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>
#using <System.dll>

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Drawing;
using namespace System::Windows::Forms;

// This attribute indicates that the public properties of this object should be listed in the property grid.

[TypeConverterAttribute(System::ComponentModel::ExpandableObjectConverter::typeid)]
public ref class DimensionData
{
private:
   Control^ owner;

internal:

   // This class reads and writes the Location and Size properties from the Control which it is initialized to.
   DimensionData( Control^ owner )
   {
      this->owner = owner;
   }

public:

   property Point Location 
   {
      Point get()
      {
         return owner->Location;
      }

      void set( Point value )
      {
         owner->Location = value;
      }

   }

   property Size FormSize 
   {
      Size get()
      {
         return owner->Size;
      }

      void set( Size value )
      {
         owner->Size = value;
      }
   }
};

// The code for this user control declares a public property of type DimensionData with a DesignerSerializationVisibility 
// attribute set to DesignerSerializationVisibility.Content, indicating that the properties of the object should be serialized.
// The public, not hidden properties of the object that are set at design time will be persisted in the initialization code
// for the class object. Content persistence will not work for structs without a custom TypeConverter.  
public ref class ContentSerializationExampleControl: public System::Windows::Forms::UserControl
{
private:
   System::ComponentModel::Container^ components;

public:

   property DimensionData^ Dimensions 
   {
      [DesignerSerializationVisibility(DesignerSerializationVisibility::Content)]
      DimensionData^ get()
      {
         return gcnew DimensionData( this );
      }
   }
   ContentSerializationExampleControl()
   {
      InitializeComponent();
   }

public:
   ~ContentSerializationExampleControl()
   {
      if ( components != nullptr )
      {
         delete components;
      }
   }

private:
   void InitializeComponent()
   {
      components = gcnew System::ComponentModel::Container;
   }
};

using System;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Windows.Forms;

namespace DesignerSerializationVisibilityTest
{
    // The code for this user control declares a public property of type DimensionData with a DesignerSerializationVisibility 
    // attribute set to DesignerSerializationVisibility.Content, indicating that the properties of the object should be serialized.

    // The public, not hidden properties of the object that are set at design time will be persisted in the initialization code
    // for the class object. Content persistence will not work for structs without a custom TypeConverter.		

    public class ContentSerializationExampleControl : System.Windows.Forms.UserControl
    {
    private System.ComponentModel.Container components = null;				
    
    [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
    public DimensionData Dimensions
    {
        get 
        {
        return new DimensionData(this);
        }		
    }

    public ContentSerializationExampleControl()
    {
            InitializeComponent();		
    }
        
    protected override void Dispose( bool disposing )
    {
        if( disposing )
        {
        if( components != null )
            components.Dispose();
        }
        base.Dispose( disposing );
    }

    private void InitializeComponent()
    {
        components = new System.ComponentModel.Container();
    }
    }

    [TypeConverterAttribute(typeof(System.ComponentModel.ExpandableObjectConverter))]
    // This attribute indicates that the public properties of this object should be listed in the property grid.
    public class DimensionData
    {		
    private Control owner;

    // This class reads and writes the Location and Size properties from the Control which it is initialized to.
    internal DimensionData(Control owner)
    {
            this.owner = owner;			
    }

    public Point Location
    {
        get
        {
        return owner.Location;
        }
        set
        {
        owner.Location = value;
        }
    }

    public Size FormSize
    {
        get
            {
        return owner.Size;
        }
        set
        {
        owner.Size = value;
        }
    }
    }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Drawing
Imports System.Windows.Forms

Namespace DesignerSerializationVisibilityTest
    _
    ' The code for this user control declares a public property of type DimensionData with a DesignerSerializationVisibility 
    ' attribute set to DesignerSerializationVisibility.Content, indicating that the properties of the object should be serialized.

    ' The public, not hidden properties of the object that are set at design time will be persisted in the initialization code
    ' for the class object. Content persistence will not work for structs without a custom TypeConverter.		
    Public Class ContentSerializationExampleControl
        Inherits System.Windows.Forms.UserControl
        Private components As System.ComponentModel.Container = Nothing


        <DesignerSerializationVisibility(DesignerSerializationVisibility.Content)> _
        Public ReadOnly Property Dimensions() As DimensionData
            Get
                Return New DimensionData(Me)
            End Get
        End Property


        Public Sub New()
            InitializeComponent()
        End Sub


        Protected Overloads Sub Dispose(ByVal disposing As Boolean)
            If disposing Then
                If (components IsNot Nothing) Then
                    components.Dispose()
                End If
            End If
            MyBase.Dispose(disposing)
        End Sub


        Private Sub InitializeComponent()
        End Sub
    End Class

    ' This attribute indicates that the public properties of this object should be listed in the property grid.
   <TypeConverterAttribute(GetType(System.ComponentModel.ExpandableObjectConverter))> _   
    Public Class DimensionData
        Private owner As Control

        ' This class reads and writes the Location and Size properties from the Control which it is initialized to.
        Friend Sub New(ByVal owner As Control)
            Me.owner = owner
        End Sub


        Public Property Location() As Point
            Get
                Return owner.Location
            End Get
            Set(ByVal Value As Point)
                owner.Location = Value
            End Set
        End Property


        Public Property FormSize() As Size
            Get
                Return owner.Size
            End Get
            Set(ByVal Value As Size)
                owner.Size = Value
            End Set
        End Property
    End Class
End Namespace 'DesignerSerializationVisibilityTest

注釈

シリアライザーは、デザイン モード ドキュメントの永続化可能な状態を保持する場合、多くの場合、デザイン時に設定されたプロパティの値を保持するために、コンポーネントの初期化メソッドにコードを追加します。 これは、他の動作を指示する属性が設定されていない場合、ほとんどの基本的な型で既定で発生します。

DesignerSerializationVisibilityAttributeを使用すると、プロパティの値が Visibleで、初期化コード で永続化する必要があるかどうかを示すことができます。また、Hidden初期化コードでは永続化しないか、 で構成Contentされます。これは、プロパティに割り当てられたオブジェクトの非表示のプロパティではなく、パブリックごとに初期化コードを生成する必要があります。

を持DesignerSerializationVisibilityAttributeたないメンバーは、 の値Visibleを持つ DesignerSerializationVisibilityAttribute として扱われます。 として Visible マークされたプロパティの値は、可能であれば、 型のシリアライザーによってシリアル化されます。 特定の型またはプロパティのカスタム シリアル化を指定するには、 を使用します DesignerSerializerAttribute。

詳細については、「属性」を参照してください。

コンストラクター

DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility)

指定した DesignerSerializationVisibility 値を使用して、DesignerSerializationVisibilityAttribute クラスの新しいインスタンスを初期化します。

フィールド

Content	シリアライザーがプロパティ自体ではなくプロパティの内容をシリアル化することを指定します。 このフィールドは読み取り専用です。
Default	既定値 (Visible) を指定します。つまり、ビジュアルなデザイナーは既定の規則を使用してプロパティの値を生成します。 static フィールドは読み取り専用です。
Hidden	シリアライザーがプロパティの値をシリアル化しないことを指定します。 static フィールドは読み取り専用です。
Visible	シリアライザーによるプロパティの値のシリアル化を許可するように指定します。 static フィールドは読み取り専用です。

プロパティ

TypeId	派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)
Visibility	プロパティの値を永続化するかどうかと永続化の方法を決定するときにシリアライザーが使用する基本的なシリアル化モードを示す値を取得します。

メソッド

Equals(Object)	このインスタンスと指定したオブジェクトが等しいかどうかを示します。
GetHashCode()	このオブジェクトのハッシュ コードを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	属性の現在の値が既定値かどうかを示す値を取得します。
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• 方法 : 標準の型のコレクションを DesignerSerializationVisibilityAttribute でシリアル化する