DesignOnlyAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.Primitives.dll

Określa, czy właściwość można ustawić tylko w czasie projektowania.

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

Dziedziczenie

Object

Attribute

DesignOnlyAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Poniższy przykład tworzy GetLanguage właściwość. Właściwość jest oznaczona znakiem 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

W następnym przykładzie zostanie uzyskana wartość .DesignOnlyAttribute Najpierw kod pobiera PropertyDescriptorCollection element ze wszystkimi właściwościami obiektu. Następnie indeksuje do właściwości , PropertyDescriptorCollection aby znaleźć GetLanguage właściwość. Następnie zwraca atrybuty tej właściwości i zapisuje je w zmiennej atrybutów.

Następnie przykład wyświetla, czy właściwość jest projektowany tylko przez pobranie DesignOnlyAttribute z elementu AttributeCollectioni zapisanie jej na ekranie konsoli.

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

Uwagi

Elementy członkowskie oznaczone zestawem DesignOnlyAttribute można ustawić true tylko w czasie projektowania. Zazwyczaj te właściwości istnieją tylko w czasie projektowania i nie odpowiadają właściwości rzeczywistej w obiekcie w czasie wykonywania.

Elementy członkowskie, które nie mają atrybutu DesignOnlyAttribute lub są oznaczone zestawem, można ustawić false w czasie wykonywania. Wartość domyślna to false.

Właściwość z ustawioną DesignOnlyAttribute wartością true ma wartość serializowaną do pliku resx zamiast InitializeComponent metody .

Aby uzyskać więcej informacji, zobacz Atrybuty.

Konstruktory

DesignOnlyAttribute(Boolean)

Inicjuje nowe wystąpienie klasy DesignOnlyAttribute.

Pola

Default	Określa wartość domyślną elementu DesignOnlyAttribute, czyli No. To static pole jest tylko do odczytu.
No	Określa, że właściwość można ustawić w czasie projektowania lub w czasie wykonywania. To static pole jest tylko do odczytu.
Yes	Określa, że właściwość można ustawić tylko w czasie projektowania. To static pole jest tylko do odczytu.

Właściwości

IsDesignOnly	Pobiera wartość wskazującą, czy właściwość można ustawić tylko w czasie projektowania.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca, czy wartość danego obiektu jest równa bieżącej DesignOnlyAttributewartości .
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	Określa, czy ten atrybut jest domyślny.
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Attribute
• PropertyDescriptor