DesignOnlyAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.Primitives.dll

Sumber:

DesignOnlyAttribute.cs

Menentukan apakah properti hanya dapat diatur pada waktu desain.

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

Warisan

Object

Attribute

DesignOnlyAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut membuat GetLanguage properti. Properti ditandai dengan 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

Contoh berikutnya mendapatkan nilai .DesignOnlyAttribute Pertama kode mendapatkan PropertyDescriptorCollection dengan semua properti untuk objek . Selanjutnya mengindeks ke PropertyDescriptorCollection dalam untuk menemukan GetLanguage properti . Kemudian mengembalikan atribut untuk properti ini dan menyimpannya dalam variabel atribut.

Contohnya kemudian mencetak apakah properti dirancang hanya dengan mengambil DesignOnlyAttribute dari AttributeCollection, dan menulisnya ke layar konsol.

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

Keterangan

Anggota yang ditandai dengan DesignOnlyAttribute set ke true hanya dapat diatur pada waktu desain. Biasanya, properti ini hanya ada pada waktu desain dan tidak sesuai dengan properti nyata pada objek pada durasi.

Anggota yang tidak memiliki atribut atau ditandai dengan DesignOnlyAttribute set ke false dapat diatur selama durasi. Default adalah false.

Properti dengan DesignOnlyAttribute set ke true memiliki nilainya yang diserialisasikan ke file .resx alih-alih InitializeComponent metode .

Untuk informasi selengkapnya, lihat Atribut.

Konstruktor

DesignOnlyAttribute(Boolean)

Menginisialisasi instans baru kelas DesignOnlyAttribute.

Bidang

Default	Menentukan nilai default untuk DesignOnlyAttribute, yaitu No. Bidang ini static bersifat baca-saja.
No	Menentukan bahwa properti dapat diatur pada waktu desain atau pada durasi. Bidang ini static bersifat baca-saja.
Yes	Menentukan bahwa properti hanya dapat diatur pada waktu desain. Bidang ini static bersifat baca-saja.

Properti

IsDesignOnly	Mendapatkan nilai yang menunjukkan apakah properti hanya dapat diatur pada waktu desain.
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan apakah nilai objek yang diberikan sama dengan saat ini DesignOnlyAttribute.
GetHashCode()	Mengembalikan kode hash untuk instans ini.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Menentukan apakah atribut ini adalah default.
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Attribute
• PropertyDescriptor