DesignOnlyAttribute クラス

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.Primitives.dll

ソース:

DesignOnlyAttribute.cs

プロパティを設定できるのがデザイン時だけかどうかを指定します。

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

次の例では、 の値を取得します 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()))

注釈

にtrue設定されたDesignOnlyAttributeメンバーは、デザイン時にのみ設定できます。 通常、これらのプロパティはデザイン時にのみ存在し、実行時のオブジェクトの実際のプロパティには対応しません。

属性を持たないメンバー、または が にfalse設定されているメンバーはDesignOnlyAttribute、実行時に設定できます。 既定値は、false です。

が DesignOnlyAttribute に true 設定されているプロパティの値は、 メソッドの代わりに .resx ファイルに InitializeComponent シリアル化されます。

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

コンストラクター

DesignOnlyAttribute(Boolean)

DesignOnlyAttribute クラスの新しいインスタンスを初期化します。

フィールド

Default	DesignOnlyAttribute の既定値 (No) を指定します。 static フィールドは読み取り専用です。
No	プロパティをデザイン時に設定できるか、または実行時に設定できるかを指定します。 static フィールドは読み取り専用です。
Yes	プロパティを設定できるのがデザイン時だけであることを指定します。 static フィールドは読み取り専用です。

プロパティ

IsDesignOnly	プロパティを設定できるのがデザイン時だけかどうかを示す値を取得します。
TypeId	派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)

メソッド

Equals(Object)	指定したオブジェクトの値が現在の DesignOnlyAttribute と等しいかどうかを示す値を返します。
GetHashCode()	このインスタンスのハッシュ コードを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	この属性が既定値かどうかを判断します。
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• Attribute
• PropertyDescriptor