DesignOnlyAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.Primitives.dll

Zdroj:

DesignOnlyAttribute.cs

Určuje, zda lze vlastnost nastavit pouze v době návrhu.

public ref class DesignOnlyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class DesignOnlyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type DesignOnlyAttribute = class
    inherit Attribute

Public NotInheritable Class DesignOnlyAttribute
Inherits Attribute

Dědičnost

Object

Attribute

DesignOnlyAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad vytvoří GetLanguage vlastnost. Vlastnost je označena znakem DesignOnlyAttribute.

public:
   [DesignOnly(true)]
   property CultureInfo^ GetLanguage 
   {
      CultureInfo^ get()
      {
         // Insert code here.
         return myCultureInfo;
      }
      void set( CultureInfo^ value )
      {
         // Insert code here.
      }
   }

[DesignOnly(true)]
 public CultureInfo GetLanguage {
    get {
       // Insert code here.
       return myCultureInfo;
    }
    set {
       // Insert code here.
    }
 }

<DesignOnly(True)> _
Public Property GetLanguage() As CultureInfo
    Get
        ' Insert code here.
        Return myCultureInfo
    End Get
    Set
        ' Insert code here.
    End Set
End Property

Další příklad získá hodnotu DesignOnlyAttribute. Nejprve kód získá objekt se PropertyDescriptorCollection všemi vlastnostmi objektu. Potom se indexuje do objektu, PropertyDescriptorCollection aby se našla GetLanguage vlastnost. Potom vrátí atributy pro tuto vlastnost a uloží je do proměnné atributů.

Příklad pak zobrazí, zda je vlastnost návrh pouze načtením DesignOnlyAttribute z objektu AttributeCollectiona zápisem na obrazovku konzoly.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "GetLanguage" ]->Attributes;

/* Prints whether the property is marked as DesignOnly 
by retrieving the DesignOnlyAttribute from the AttributeCollection. */
DesignOnlyAttribute^ myAttribute = dynamic_cast<DesignOnlyAttribute^>(attributes[ DesignOnlyAttribute::typeid ]);
Console::WriteLine( "This property is design only :{0}", myAttribute->IsDesignOnly );

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["GetLanguage"].Attributes;

 /* Prints whether the property is marked as DesignOnly 
  * by retrieving the DesignOnlyAttribute from the AttributeCollection. */
 DesignOnlyAttribute myAttribute = 
    (DesignOnlyAttribute)attributes[typeof(DesignOnlyAttribute)];
 Console.WriteLine("This property is design only :" +
    myAttribute.IsDesignOnly.ToString());

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("GetLanguage").Attributes

' Prints whether the property is marked as DesignOnly 
' by retrieving the DesignOnlyAttribute from the AttributeCollection.
Dim myAttribute As DesignOnlyAttribute = _
    CType(attributes(GetType(DesignOnlyAttribute)), DesignOnlyAttribute)
Console.WriteLine(("This property is design only :" & _
    myAttribute.IsDesignOnly.ToString()))

Poznámky

Členy označené nastavenou DesignOnlyAttribute jako true lze nastavit pouze v době návrhu. Tyto vlastnosti obvykle existují pouze v době návrhu a neodpovídají skutečné vlastnosti objektu za běhu.

Členy, kteří nemají žádný atribut nebo jsou označeni nastavenou DesignOnlyAttribute na false , lze nastavit během běhu. Výchozí formát je false.

Vlastnost s nastavenou DesignOnlyAttribute na true má hodnotu serializovanou do souboru .resx místo InitializeComponent metody.

Další informace najdete v tématu Atributy.

Konstruktory

DesignOnlyAttribute(Boolean)

Inicializuje novou instanci DesignOnlyAttribute třídy.

Pole

Default	Určuje výchozí hodnotu pro DesignOnlyAttribute, což je No. Toto static pole je jen pro čtení.
No	Určuje, že vlastnost může být nastavena v době návrhu nebo v době běhu. Toto static pole je jen pro čtení.
Yes	Určuje, že vlastnost lze nastavit pouze v době návrhu. Toto static pole je jen pro čtení.

Vlastnosti

IsDesignOnly	Získá hodnotu označující, zda vlastnost lze nastavit pouze v době návrhu.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)

Metody

Equals(Object)	Vrátí, zda je hodnota daného objektu rovna aktuálnímu DesignOnlyAttributeobjektu .
GetHashCode()	Vrátí hodnotu hash pro tuto instanci.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Určuje, jestli je tento atribut výchozí.
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