DesignerSerializationVisibilityAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.Primitives.dll

Zdroj:

DesignerSerializationVisibilityAttribute.cs

Určuje typ trvalosti použít při serializaci vlastnosti komponenty v době návrhu.

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

Dědičnost

Object

Attribute

DesignerSerializationVisibilityAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad kódu ukazuje použití DesignerSerializationVisibilityAttribute sady na Content. Zachová hodnoty veřejné vlastnosti uživatelského ovládacího prvku, které lze nakonfigurovat při návrhu. Pokud chcete použít příklad, nejprve zkompilujte následující kód do knihovny uživatelských ovládacích prvků. Dále přidejte odkaz na zkompilovaný soubor .dll v novém projektu aplikace systému Windows. Pokud používáte Visual Studio, ContentSerializationExampleControl přidá se automaticky do sady nástrojů.

Přetáhněte ovládací prvek z panelu nástrojů do formuláře a nastavte vlastnosti objektu DimensionData uvedeného v okno Vlastnosti. Při zobrazení kódu formuláře bude kód přidán do InitializeComponent metody nadřazeného formuláře. Tento kód nastaví hodnoty vlastností ovládacího prvku na ty, které jste nastavili v režimu návrhu.

#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

Poznámky

Když serializátor zachová trvalý stav dokumentu režimu návrhu, často přidá kód do inicializační metody součástí k zachování hodnot vlastností, které byly nastaveny v době návrhu. K tomu ve výchozím nastavení dochází u většiny základních typů, pokud nebyl žádný atribut nastaven tak, aby směroval jiné chování.

DesignerSerializationVisibilityAttributePomocí můžete určit, jestli je Visiblehodnota vlastnosti , a měla by se uchovávat v inicializačním kódu Hiddena neměla by se uchovávat v inicializačním kódu, nebo se skládá z Content, který by měl mít inicializační kód vygenerovaný pro každou veřejnou, nikoli skrytou vlastnost objektu přiřazeného vlastnosti.

Se členy, kteří nemají DesignerSerializationVisibilityAttribute , se bude zacházet, jako by měli s DesignerSerializationVisibilityAttribute hodnotou Visible. Hodnoty vlastnosti označené jako Visible budou serializovány, pokud je to možné serializátorem pro typ. Chcete-li zadat vlastní serializaci pro konkrétní typ nebo vlastnost, použijte DesignerSerializerAttribute.

Další informace najdete v tématu Atributy.

Konstruktory

DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility)

Inicializuje novou instanci DesignerSerializationVisibilityAttribute třídy pomocí zadané DesignerSerializationVisibility hodnoty.

Pole

Content	Určuje, že serializátor by měl serializovat obsah vlastnosti, nikoli samotnou vlastnost. Toto pole je jen ke čtení.
Default	Určuje výchozí hodnotu, což je Visible, to znamená, že vizuální návrhář používá výchozí pravidla k vygenerování hodnoty vlastnosti. Toto static pole je jen pro čtení.
Hidden	Určuje, že serializátor by neměl serializovat hodnotu vlastnosti. Toto static pole je jen pro čtení.
Visible	Určuje, že serializátoru by mělo být povoleno serializovat hodnotu vlastnosti. Toto static pole je jen pro čtení.

Vlastnosti

TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)
Visibility	Získá hodnotu označující základní režim serializace serializátor by měl použít při určování, zda a jak zachovat hodnotu vlastnosti.

Metody

Equals(Object)	Udává, zda je tato instance totožná se zadaným objektem.
GetHashCode()	Vrátí kód hash pro tento objekt.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Získá hodnotu označující, zda aktuální hodnota atributu je výchozí hodnota atributu.
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• Postupy: Serializace kolekcí standardních typů s DesignerSerializationVisibilityAttribute