DesignOnlyAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.Primitives.dll

Źródło:

DesignOnlyAttribute.cs

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 symbolem 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

Następny przykład pobiera wartość .DesignOnlyAttribute Najpierw kod pobiera PropertyDescriptorCollection obiekt ze wszystkimi właściwościami obiektu. Następnie indeksuje do PropertyDescriptorCollection właściwości , 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 projektowa tylko przez pobranie DesignOnlyAttribute z AttributeCollectionobiektu i 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 obiektu w czasie wykonywania.

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

Właściwość z zestawem DesignOnlyAttributetrue ma swoją 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ą DesignOnlyAttributeelementu , 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 Attributeelementu . (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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Określa, czy ten atrybut jest domyślny.
Match(Object)	Po przesłonięciu 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