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の値を取得します。 まず、コードはオブジェクトのすべてのプロパティを含む PropertyDescriptorCollection を取得します。 次に、 PropertyDescriptorCollection にインデックスを作成して、 GetLanguage プロパティを検索します。 次に、このプロパティの属性を返し、属性変数に保存します。

次に、プロパティがデザインであるかどうかを出力するには、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 に設定されているプロパティの値は、InitializeComponent メソッドではなく .resx ファイルにシリアル化されます。

詳細については、「属性」を参照してください。

こちらもご覧ください

• Attribute
• PropertyDescriptor