DesignOnlyAttribute Třída

Definice

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
public sealed class DesignOnlyAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type DesignOnlyAttribute = class
    inherit Attribute
type DesignOnlyAttribute = class
    inherit Attribute
Public NotInheritable Class DesignOnlyAttribute
Inherits Attribute
Dědičnost
DesignOnlyAttribute
Atributy

Příklady

Následující příklad vytvoří GetLanguage vlastnost . Vlastnost je označená 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 . Dále indexuje do objektu , PropertyDescriptorCollection aby se našla GetLanguage vlastnost . Potom vrátí atributy pro tuto vlastnost a uloží je do proměnné attributes.

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 na 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ří buď nemají žádný atribut, nebo jsou označeni nastaveným DesignOnlyAttribute na false , lze nastavit během doby běhu. Výchozí formát je false.

Vlastnost s nastavenou DesignOnlyAttribute na true má svou hodnotu serializována do souboru .resx namí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 lze nastavit v době návrhu nebo za 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()

Type Získá z aktuální instance.

(Zděděno od Object)
IsDefaultAttribute()

Určuje, jestli je tento atribut výchozí.

IsDefaultAttribute()

Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu.

(Zděděno od Attribute)
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)

Explicitní implementace rozhraní

_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)

Platí pro

Viz také