DesignerSerializationVisibilityAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Source:

DesignerSerializationVisibilityAttribute.cs

Spécifie le type de persistance à utiliser lors de la sérialisation de la propriété d'un composant au moment du design.

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

Héritage

Object

Attribute

DesignerSerializationVisibilityAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple de code suivant illustre l’utilisation d’une DesignerSerializationVisibilityAttribute valeur définie sur Content. Il conserve les valeurs d’une propriété publique d’un contrôle utilisateur, qui peut être configurée au moment de la conception. Pour utiliser l’exemple, commencez par compiler le code suivant dans une bibliothèque de contrôles utilisateur. Ensuite, ajoutez une référence au fichier .dll compilé dans un nouveau projet d’application Windows. Si vous utilisez Visual Studio, le ContentSerializationExampleControl est automatiquement ajouté à la boîte à outils.

Faites glisser le contrôle de la boîte à outils vers un formulaire et définissez les propriétés de l’objet DimensionData répertorié dans le Fenêtre Propriétés. Lorsque vous affichez le code du formulaire, le code a été ajouté à la InitializeComponent méthode du formulaire parent. Ce code définit les valeurs des propriétés du contrôle sur celles que vous avez définies en mode création.

#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

Remarques

Lorsqu’un sérialiseur conserve l’état persistant d’un document en mode conception, il ajoute souvent du code à la méthode d’initialisation des composants pour conserver les valeurs des propriétés qui ont été définies au moment de la conception. Cela se produit par défaut pour la plupart des types de base, si aucun attribut n’a été défini pour diriger un autre comportement.

Avec , DesignerSerializationVisibilityAttributevous pouvez indiquer si la valeur d’une propriété est Visible, et doit être conservée dans le code d’initialisation, Hiddenet ne doit pas être conservée dans le code d’initialisation, ou se compose de , qui doit avoir du code d’initialisation Contentgénéré pour chaque propriété publique, et non masquée de l’objet affecté à la propriété.

Les membres qui n’ont pas de DesignerSerializationVisibilityAttribute seront traités comme s’ils ont une DesignerSerializationVisibilityAttribute valeur de Visible. Les valeurs d’une propriété marquée comme Visible seront sérialisées, si possible, par un sérialiseur pour le type. Pour spécifier la sérialisation personnalisée pour un type ou une propriété particulier, utilisez .DesignerSerializerAttribute

Pour plus d’informations, consultez Attributs.

Constructeurs

DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility)

Initialise une nouvelle instance de la classe DesignerSerializationVisibilityAttribute avec la valeur DesignerSerializationVisibility spécifiée.

Champs

Content	Spécifie qu'un sérialiseur doit sérialiser le contenu de la propriété, plutôt que la propriété elle-même. Ce champ est en lecture seule.
Default	Spécifie la valeur par défaut qui est Visible, autrement dit, un concepteur visuel utilise des règles par défaut pour générer la valeur d'une propriété. Ce champ static est en lecture seule.
Hidden	Spécifie qu'un sérialiseur ne doit pas sérialiser la valeur de la propriété. Ce champ static est en lecture seule.
Visible	Spécifie qu'un sérialiseur ne doit pas être autorisé à sérialiser la valeur de la propriété. Ce champ static est en lecture seule.

Propriétés

TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
Visibility	Obtient une valeur indiquant le mode de sérialisation de base qu'un sérialiseur doit utiliser lorsqu'il détermine si la valeur d'une propriété doit être rendue persistante et comment.

Méthodes

Equals(Object)	Indique si cette instance et un objet spécifié sont égaux.
GetHashCode()	Retourne le code de hachage pour cet objet.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	Obtient une valeur indiquant si la valeur actuelle de l'attribut est sa valeur par défaut.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• Comment : sérialiser des collections de types standard avec DesignerSerializationVisibilityAttribute