DesignOnlyAttribute 類別

定義

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

繼承

Object

Attribute

DesignOnlyAttribute

屬性

AttributeUsageAttribute

範例

以下範例會產生一個 GetLanguage 性質。 該性質以 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

下一個例子得到 的 DesignOnlyAttribute值為 。 首先，程式碼會取得包含物件所有屬性的 a PropertyDescriptorCollection 。 接著它會索引到該PropertyDescriptorCollectionGetLanguage物業。 接著它會回傳這個屬性的屬性，並儲存在屬性變數中。

範例接著透過從 AttributeCollection取DesignOnlyAttribute出並寫入主控台畫面，來列印該屬性是否為設計。

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

備註

標示 DesignOnlyAttribute 為 的 true 構件只能在設計時設定。 通常，這些屬性只存在於設計時，且不對應執行時物件上的實體屬性。

沒有屬性或標記為 DesignOnlyAttribute 的 false 成員可在執行時被設定。 預設值為 false。

將 DesignOnlyAttribute 為 的 true 屬性，其值會序列化到 .resx 檔案，而非方法本身 InitializeComponent 。

如需詳細資訊，請參閱屬性。

另請參閱

• Attribute
• PropertyDescriptor