Windows フォーム コントロールの属性
.NET Framework には、カスタム コントロールとコンポーネントのメンバーに適用できるさまざまな属性が用意されています。 これらの属性の中には、クラスの実行時の動作に影響するものもあれば、デザイン時の動作に影響するものがあります。
注意
このコンテンツは.NET Framework 用に作成されました。 .NET 6 以降のバージョンを使用している場合は、このコンテンツを慎重に使用してください。 Windows フォームのデザイナー システムが変更されたため、.NET Framework 記事以降の
コントロールプロパティとコンポーネントプロパティの属性
次の表に、カスタム コントロールとコンポーネントのプロパティまたは他のメンバーに適用できる属性を示します。 これらの属性の多くを使用する例については、「方法: Windows フォーム コントロールで属性を適用する」を参照してください。
属性 | 説明 |
---|---|
AmbientValueAttribute | プロパティに渡す値を指定して、プロパティが別のソースから値を取得します。 これは "アンビエンス" と呼ばれています。 |
BrowsableAttribute | プロパティまたはイベントを プロパティ ウィンドウに表示するかどうかを指定します。 |
CategoryAttribute | Categorized モードに設定された PropertyGrid コントロールに表示されるときに、プロパティまたはイベントをグループ化するカテゴリの名前を指定します。 |
DefaultValueAttribute | プロパティの既定値を指定します。 |
DescriptionAttribute | プロパティまたはイベントの説明を指定します。 |
DisplayNameAttribute | 引数を受け取たないプロパティ、イベント、または public void メソッドの表示名を指定します。 |
EditorAttribute | プロパティの変更に使用するエディターを指定します。 |
EditorBrowsableAttribute | プロパティまたはメソッドがエディターで表示可能であることを指定します。 |
HelpKeywordAttribute | クラスまたはメンバーのコンテキスト キーワードを指定します。 |
LocalizableAttribute | プロパティをローカライズするかどうかを指定します。 |
PasswordPropertyTextAttribute | オブジェクトのテキスト表現がアスタリスクなどの文字で隠されることを示します。 |
ReadOnlyAttribute | この属性がバインドされるプロパティを、デザイン時に読み取り専用にするか、読み取り/書き込みするかを指定します。 |
RefreshPropertiesAttribute | 関連付けられているプロパティ値が変更されたときに、プロパティ グリッドを更新する必要があることを示します。 |
TypeConverterAttribute | この属性がバインドされているオブジェクトのコンバーターとして使用する型を指定します。 |
データ バインディング プロパティの属性
次の表に、カスタム コントロールとコンポーネントがデータ バインディングと対話する方法を指定するために適用できる属性を示します。
属性 | 説明 |
---|---|
BindableAttribute | プロパティをバインドに通常使用するかどうかを指定します。 |
ComplexBindingPropertiesAttribute | コンポーネントのデータ ソースとデータ メンバーのプロパティを指定します。 |
DefaultBindingPropertyAttribute | コンポーネントの既定のバインド プロパティを指定します。 |
LookupBindingPropertiesAttribute | コンポーネントのデータ ソースとデータ メンバーのプロパティを指定します。 |
AttributeProviderAttribute | 属性のリダイレクトを有効にします。 |
クラスの属性
次の表に、デザイン時にカスタム コントロールとコンポーネントの動作を指定するために適用できる属性を示します。
属性 | 説明 |
---|---|
DefaultEventAttribute | コンポーネントの既定のイベントを指定します。 |
DefaultPropertyAttribute | コンポーネントの既定のプロパティを指定します。 |
DesignerAttribute | コンポーネントのデザイン時サービスを実装するために使用するクラスを指定します。 |
DesignerCategoryAttribute | クラスのデザイナーが特定のカテゴリに属することを指定します。 |
ToolboxItemAttribute | ツールボックス項目の属性を表します。 |
ToolboxItemFilterAttribute | ツールボックス項目に使用するフィルター文字列とフィルターの種類を指定します。 |
こちらもご覧ください
- Attribute
- 方法: Windows フォーム コントロールに属性を適用する
- デザイン時サポートの拡張
- .NET Framework を使用したカスタム Windows フォーム コントロールの開発
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET Desktop feedback