DesignOnlyAttribute Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvények:

netstandard.dll, System.ComponentModel.Primitives.dll

Forrás:

DesignOnlyAttribute.cs

Megadja, hogy egy tulajdonság csak a tervezéskor állítható-e be.

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

Öröklődés

Object

Attribute

DesignOnlyAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa létrehoz egy tulajdonságot GetLanguage . A tulajdonságot egy 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

A következő példa a DesignOnlyAttribute. Először a kód lekéri PropertyDescriptorCollection az objektum összes tulajdonságát. Ezután indexeli a PropertyDescriptorCollection tulajdonságot GetLanguage . Ezután visszaadja a tulajdonság attribútumait, és menti őket az attribútumváltozóba.

A példa ezután kinyomtatja, hogy a tulajdonság csak úgy van-e megtervezve, hogy beolvassa DesignOnlyAttribute a konzol képernyőjére, majd beolvassa a AttributeCollectionkonzol képernyőjére.

// 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()))

Megjegyzések

A készlettel DesignOnlyAttributetrue megjelölt tagok csak a tervezéskor állíthatók be. Ezek a tulajdonságok általában csak tervezési időben léteznek, és futásidőben nem felelnek meg az objektum egy valós tulajdonságának.

Azok a tagok, amelyek nem rendelkeznek attribútummal, vagy a készlettel vannak megjelölve, DesignOnlyAttributefalse futás közben is beállíthatók. Az alapértelmezett érték a false.

Egy olyan tulajdonság, DesignOnlyAttribute amelynek értéke a true metódus helyett InitializeComponent a .resx fájlra van szerializálva.

További információ: Attribútumok.

Konstruktorok

Name	Description
DesignOnlyAttribute(Boolean)	Inicializálja a DesignOnlyAttribute osztály új példányát.

Mezők

Name	Description
Default	Az alapértelmezett értéket adja meg a DesignOnlyAttribute( vagyis No) értékhez. Ez static a mező írásvédett.
No	Megadja, hogy egy tulajdonság beállítható a tervezéskor vagy futásidőben. Ez static a mező írásvédett.
Yes	Azt határozza meg, hogy egy tulajdonság csak a tervezéskor állítható be. Ez static a mező írásvédett.

Tulajdonságok

Name	Description
IsDesignOnly	Olyan értéket kap, amely jelzi, hogy egy tulajdonság csak a tervezéskor állítható-e be.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Azt adja vissza, hogy az adott objektum értéke megegyezik-e az aktuális DesignOnlyAttributeértékkel.
GetHashCode()	A példány kivonatkódját adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Meghatározza, hogy ez az attribútum-e az alapértelmezett érték.
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• Attribute
• PropertyDescriptor