DesignOnlyAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.dll

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 značkou 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.
        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á PropertyDescriptorCollection všechny vlastnosti objektu. Dále indexuje do objektu PropertyDescriptorCollectionGetLanguage pro vyhledání vlastnosti. Pak vrátí atributy pro tuto vlastnost a uloží je do proměnné atributů.

Příklad pak vytiskne, zda je vlastnost navržena 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é DesignOnlyAttribute sadou 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.

Členové, kteří nemají žádný atribut nebo jsou označeni nastaveným DesignOnlyAttribute nastavením false , lze nastavit během běhu. Výchozí hodnota je false.

Vlastnost se nastavenou DesignOnlyAttribute hodnotou true má serializována do souboru .resx místo InitializeComponent metody.

Další informace naleznete v tématu Atributy.

Konstruktory

Name	Description
DesignOnlyAttribute(Boolean)	Inicializuje novou instanci DesignOnlyAttribute třídy.

Pole

Name	Description
Default	Určuje výchozí hodnotu pro DesignOnlyAttributehodnotu , která 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

Name	Description
IsDesignOnly	Získá hodnotu urč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 tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí, zda hodnota daného objektu je rovna aktuální DesignOnlyAttribute.
GetHashCode()	Vrátí kód hash pro tuto instanci.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Určuje, zda je tento atribut výchozí.
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní. (Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute)

Viz také

• Attribute
• PropertyDescriptor