DesignOnlyAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.ComponentModel.Primitives.dll

Source:

DesignOnlyAttribute.cs

Bir özelliğin yalnızca tasarım zamanında ayarlanıp ayarlanamayacağını belirtir.

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

Devralma

Object

Attribute

DesignOnlyAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek bir GetLanguage özellik oluşturur. özelliği ile DesignOnlyAttributeişaretlenir.

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

Sonraki örnek değerini DesignOnlyAttributealır. İlk olarak kod, nesnenin tüm özelliklerine sahip bir PropertyDescriptorCollection alır. PropertyDescriptorCollection Ardından özelliğini bulmak için dizinini oluştururGetLanguage. Ardından bu özelliğin özniteliklerini döndürür ve öznitelikler değişkenine kaydeder.

Örnek daha sonra özelliğin tasarım olup olmadığını yalnızca içinden AttributeCollectionalıp DesignOnlyAttribute konsol ekranına yazarak yazdırır.

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

Açıklamalar

olarak işaretlenmiş DesignOnlyAttributetrue üyeler yalnızca tasarım zamanında ayarlanabilir. Genellikle, bu özellikler yalnızca tasarım zamanında bulunur ve çalışma zamanında nesnedeki gerçek bir özelliğe karşılık değildir.

Özniteliği olmayan veya olarak ayarlanmış false olarak DesignOnlyAttribute işaretlenmiş üyeler çalışma zamanında ayarlanabilir. Varsayılan değer: false.

değerine ayarlanmış true bir özelliğin DesignOnlyAttribute değeri yöntemi yerine .resx dosyası olarak InitializeComponent seri hale getirilmiştir.

Daha fazla bilgi için bkz . Öznitelikler.

Oluşturucular

DesignOnlyAttribute(Boolean)

DesignOnlyAttribute sınıfının yeni bir örneğini başlatır.

Alanlar

Default	için DesignOnlyAttributeNovarsayılan değerini belirtir. Bu static alan salt okunur.
No	Bir özelliğin tasarım zamanında veya çalışma zamanında ayarlanabileceğini belirtir. Bu static alan salt okunur.
Yes	Bir özelliğin yalnızca tasarım zamanında ayarlanabileceğini belirtir. Bu static alan salt okunur.

Özellikler

IsDesignOnly	Bir özelliğin yalnızca tasarım zamanında ayarlanıp ayarlanamayacağını belirten bir değer alır.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Equals(Object)	Verilen nesnenin değerinin geçerli DesignOnlyAttributedeğerine eşit olup olmadığını döndürür.
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Bu özniteliğin varsayılan olup olmadığını belirler.
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Attribute
• PropertyDescriptor