PropertyDescriptor

.NET Framework クラス ライブラリ リファレンス

PropertyDescriptor クラス

クラスのプロパティの抽象化を提供します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public MustInherit Class
 PropertyDescriptor
    Inherits MemberDescriptor

Visual Basic (使用法)

Dim instance As PropertyDescriptor

C#

[ComVisibleAttribute(true)] 
public abstract class PropertyDescriptor :
 MemberDescriptor

C++

[ComVisibleAttribute(true)] 
public ref class PropertyDescriptor abstract
 : public MemberDescriptor

J#

/** @attribute ComVisibleAttribute(true) */ 
public abstract class PropertyDescriptor extends
 MemberDescriptor

JScript

ComVisibleAttribute(true) 
public abstract class PropertyDescriptor extends
 MemberDescriptor

解説

プロパティの説明は、プロパティの名前、属性、そのプロパティが関連付けられているコンポーネント クラス、およびプロパティの型で構成されています。

PropertyDescriptor は、次のプロパティとメソッドを提供します。

• Converter は、このプロパティの TypeConverter を格納しています。

• IsLocalizable は、プロパティをローカライズする必要があるかどうかを示します。

• GetEditor は、指定した型のエディタを返します。

また、PropertyDescriptor は、次の abstract のプロパティとメソッドを提供します。

• ComponentType は、プロパティが関連付けられているコンポーネントの型を格納します。

• IsReadOnly は、プロパティが読み取り専用かどうかを示します。

• PropertyType は、プロパティの型を取得します。

• CanResetValue は、コンポーネントをリセットすると、コンポーネントの値が変化するかどうかを示します。

• GetValue は、コンポーネントのプロパティの現在の値を返します。

• ResetValue は、コンポーネントのプロパティの値をリセットします。

• SetValue は、コンポーネントの値を別の値に設定します。

• ShouldSerializeValue は、プロパティの値を永続化する必要があるかどうかを示します。

通常、abstract メンバはリフレクションによって実装されます。リフレクションの詳細については、リフレクション のトピックを参照してください。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

PropertyDescriptorCollection クラスの例に基づいて構築されているコード例を次に示します。テキスト ボックス内のボタンのテキストに関する情報 (カテゴリ、説明、表示名) を出力します。この例は、button1 と textbox1 がフォーム上でインスタンス化されていることを前提としています。

Visual Basic

' Creates a new collection and assign it the properties for button1.
Dim properties As PropertyDescriptorCollection
 = TypeDescriptor.GetProperties(Button1)

' Sets an PropertyDescriptor to the specific property.
Dim myProperty As PropertyDescriptor = properties.Find("Text",
 False)

' Prints the property and the property description.
TextBox1.Text += myProperty.DisplayName & Microsoft.VisualBasic.ControlChars.Cr
TextBox1.Text += myProperty.Description & Microsoft.VisualBasic.ControlChars.Cr
TextBox1.Text += myProperty.Category & Microsoft.VisualBasic.ControlChars.Cr

C#

// Creates a new collection and assign it the properties for button1.
PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);

// Sets an PropertyDescriptor to the specific property.
System.ComponentModel.PropertyDescriptor myProperty = properties.Find("Text",
 false);

// Prints the property and the property description.
textBox1.Text = myProperty.DisplayName+ '\n' ;
textBox1.Text += myProperty.Description + '\n';
textBox1.Text += myProperty.Category + '\n';

C++

// Creates a new collection and assign it the properties for button1.
PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1
 );

// Sets an PropertyDescriptor to the specific property.
System::ComponentModel::PropertyDescriptor^ myProperty = properties->Find( "Text",
 false );

// Prints the property and the property description.
textBox1->Text = String::Concat( myProperty->DisplayName, "\n" );
textBox1->Text = String::Concat( textBox1->Text, myProperty->Description,
 "\n" );
textBox1->Text = String::Concat( textBox1->Text, myProperty->Category, "\n"
 );

J#

// Creates a new collection and assign it the properties for button1.
PropertyDescriptorCollection properties = 
    TypeDescriptor.GetProperties(button1);
// Sets an PropertyDescriptor to the specific property.
System.ComponentModel.PropertyDescriptor myProperty = 
    properties.Find("Text", false);
// Prints the property and the property description.
textBox1.set_Text(myProperty.get_DisplayName() + 'n');
textBox1.set_Text(textBox1.get_Text() + myProperty.get_Description() 
    + '\n');
textBox1.set_Text(textBox1.get_Text() + myProperty.get_Category()
    + '\n');

継承階層

System.Object
   System.ComponentModel.MemberDescriptor
    System.ComponentModel.PropertyDescriptor
       System.ComponentModel.TypeConverter.SimplePropertyDescriptor

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
PropertyDescriptor メンバ
System.ComponentModel 名前空間
MemberDescriptor クラス
Attribute
DefaultValueAttribute クラス

PropertyDescriptor コンストラクタ (String, Attribute[])

名前と属性を指定して、PropertyDescriptor クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    name As String, _
    attrs As Attribute() _
)

Visual Basic (使用法)

Dim name As String
Dim attrs As Attribute()

Dim instance As New PropertyDescriptor(name,
 attrs)

C#

protected PropertyDescriptor (
    string name,
    Attribute[] attrs
)

C++

protected:
PropertyDescriptor (
    String^ name, 
    array<Attribute^>^ attrs
)

J#

protected PropertyDescriptor (
    String name, 
    Attribute[] attrs
)

JScript

protected function PropertyDescriptor (
    name : String, 
    attrs : Attribute[]
)

パラメータ

name

プロパティの名前。

attrs

プロパティの属性を格納している Attribute 型の配列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
PropertyDescriptor クラス
PropertyDescriptor メンバ
System.ComponentModel 名前空間
Attribute

PropertyDescriptor コンストラクタ

PropertyDescriptor クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
PropertyDescriptor (MemberDescriptor)	指定した MemberDescriptor 内の名前と属性を使用して、PropertyDescriptor クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
PropertyDescriptor (MemberDescriptor, Attribute[])	指定した MemberDescriptor 内の名前と、MemberDescriptor および Attribute 配列の両方に格納されている属性を使用して、PropertyDescriptor クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
PropertyDescriptor (String, Attribute[])	名前と属性を指定して、PropertyDescriptor クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

PropertyDescriptor クラス
PropertyDescriptor メンバ
System.ComponentModel 名前空間
MemberDescriptor クラス

PropertyDescriptor コンストラクタ (MemberDescriptor, Attribute[])

指定した MemberDescriptor 内の名前と、MemberDescriptor および Attribute 配列の両方に格納されている属性を使用して、PropertyDescriptor クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    descr As MemberDescriptor, _
    attrs As Attribute() _
)

Visual Basic (使用法)

Dim descr As MemberDescriptor
Dim attrs As Attribute()

Dim instance As New PropertyDescriptor(descr,
 attrs)

C#

protected PropertyDescriptor (
    MemberDescriptor descr,
    Attribute[] attrs
)

C++

protected:
PropertyDescriptor (
    MemberDescriptor^ descr, 
    array<Attribute^>^ attrs
)

J#

protected PropertyDescriptor (
    MemberDescriptor descr, 
    Attribute[] attrs
)

JScript

protected function PropertyDescriptor (
    descr : MemberDescriptor, 
    attrs : Attribute[]
)

パラメータ

descr

メンバの名前とその属性を格納している MemberDescriptor。

attrs

プロパティに関連付ける属性を格納している Attribute 配列。

解説

このコンストラクタは、Attribute 配列内の属性を MemberDescriptor 内の属性の末尾に追加します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
PropertyDescriptor クラス
PropertyDescriptor メンバ
System.ComponentModel 名前空間
MemberDescriptor クラス
Attribute

PropertyDescriptor コンストラクタ (MemberDescriptor)

指定した MemberDescriptor 内の名前と属性を使用して、PropertyDescriptor クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    descr As MemberDescriptor _
)

Visual Basic (使用法)

Dim descr As MemberDescriptor

Dim instance As New PropertyDescriptor(descr)

C#

protected PropertyDescriptor (
    MemberDescriptor descr
)

C++

protected:
PropertyDescriptor (
    MemberDescriptor^ descr
)

J#

protected PropertyDescriptor (
    MemberDescriptor descr
)

JScript

protected function PropertyDescriptor (
    descr : MemberDescriptor
)

パラメータ

descr

プロパティの名前と属性を格納している MemberDescriptor。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
PropertyDescriptor クラス
PropertyDescriptor メンバ
System.ComponentModel 名前空間
MemberDescriptor クラス

PropertyDescriptor プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Attributes	メンバの属性のコレクションを取得します。 ( MemberDescriptor から継承されます。)
	Category	CategoryAttribute で指定されている、メンバが属するカテゴリの名前を取得します。 ( MemberDescriptor から継承されます。)
	Converter	プロパティの型コンバータを取得します。
	Description	DescriptionAttribute で指定されている、メンバの説明を取得します。 ( MemberDescriptor から継承されます。)
	DesignTimeOnly	DesignOnlyAttribute で指定されている、メンバを設定できるのがデザイン時だけかどうかを示す値を取得します。 ( MemberDescriptor から継承されます。)
	DisplayName	[プロパティ] ウィンドウなどのウィンドウに表示できる名前を取得します。 ( MemberDescriptor から継承されます。)
	IsBrowsable	BrowsableAttribute で指定されている、メンバが参照可能かどうかを示す値を取得します。 ( MemberDescriptor から継承されます。)
	Name	メンバの名前を取得します。 ( MemberDescriptor から継承されます。)
	SupportsChangeEvents	このプロパティの値変更通知をプロパティ記述子以外から発生させてよいかどうかを示す値を取得します。

プロテクト プロパティ

	名前	説明
	AttributeArray	属性の配列を取得または設定します。 ( MemberDescriptor から継承されます。)
	NameHashCode	GetHashCode で指定されている、メンバの名前のハッシュ コードを取得します。 ( MemberDescriptor から継承されます。)

参照

関連項目

PropertyDescriptor クラス
System.ComponentModel 名前空間
MemberDescriptor クラス
Attribute
DefaultValueAttribute クラス

PropertyDescriptor メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddValueChanged	プロパティが変更されたときに、ほかのオブジェクトに通知できるようにします。
	CanResetValue	派生クラスでオーバーライドされた場合、オブジェクトをリセットしたときに、そのオブジェクトの値が変化するかどうかを示す値を返します。
	Equals	オーバーロードされます。 オーバーライドされます。 プロパティ記述子を別のオブジェクトと比較して、等しいかどうかを確認します。
	GetChildProperties	オーバーロードされます。 PropertyDescriptorCollection を返します。
	GetEditor	指定した型のエディタを取得します。
	GetHashCode	オーバーライドされます。 このオブジェクトのハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetValue	派生クラスでオーバーライドされた場合、コンポーネントのプロパティの現在の値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RemoveValueChanged	プロパティが変更されたときに、ほかのオブジェクトに通知できるようにします。
	ResetValue	派生クラスでオーバーライドされた場合、コンポーネントのプロパティの値を既定値にリセットします。
	SetValue	派生クラスでオーバーライドされた場合、コンポーネントの値を別の値に設定します。
	ShouldSerializeValue	派生クラスでオーバーライドされた場合、プロパティの値を永続化する必要があるかどうかを示す値を決定します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	CreateAttributeCollection	コンストラクタに渡された属性配列を使用して、属性のコレクションを作成します。 ( MemberDescriptor から継承されます。)
	CreateInstance	指定した型のインスタンスを作成します。
	FillAttributes	オーバーライドされます。 指定した親クラスの属性リストに PropertyDescriptor の属性を追加します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	FindMethod	オーバーロードされます。 指定したメソッドをリフレクションによって検索します。 ( MemberDescriptor から継承されます。)
	GetInvocationTarget	オーバーライドされます。 このメソッドでは、メンバの呼び出し中に使用するオブジェクトが返されます。
	GetInvokee	メソッドを呼び出す対象のコンポーネントを取得します。 ( MemberDescriptor から継承されます。)
	GetSite	指定したコンポーネントのコンポーネント サイトを取得します。 ( MemberDescriptor から継承されます。)
	GetTypeFromName	型名を使用して型を返します。
	GetValueChangedHandler	特定のコンポーネントについて現在の ValueChanged イベント ハンドラ セットを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnValueChanged	実装した ValueChanged イベントを発生させます。

参照

関連項目

PropertyDescriptor クラス
System.ComponentModel 名前空間
MemberDescriptor クラス
Attribute
DefaultValueAttribute クラス

PropertyDescriptor メンバ

クラスのプロパティの抽象化を提供します。

PropertyDescriptor データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	PropertyDescriptor	オーバーロードされます。 PropertyDescriptor クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Attributes	メンバの属性のコレクションを取得します。(MemberDescriptor から継承されます。)
	Category	CategoryAttribute で指定されている、メンバが属するカテゴリの名前を取得します。(MemberDescriptor から継承されます。)
	Converter	プロパティの型コンバータを取得します。
	Description	DescriptionAttribute で指定されている、メンバの説明を取得します。(MemberDescriptor から継承されます。)
	DesignTimeOnly	DesignOnlyAttribute で指定されている、メンバを設定できるのがデザイン時だけかどうかを示す値を取得します。(MemberDescriptor から継承されます。)
	DisplayName	[プロパティ] ウィンドウなどのウィンドウに表示できる名前を取得します。(MemberDescriptor から継承されます。)
	IsBrowsable	BrowsableAttribute で指定されている、メンバが参照可能かどうかを示す値を取得します。(MemberDescriptor から継承されます。)
	Name	メンバの名前を取得します。(MemberDescriptor から継承されます。)
	SupportsChangeEvents	このプロパティの値変更通知をプロパティ記述子以外から発生させてよいかどうかを示す値を取得します。

プロテクト プロパティ

	名前	説明
	AttributeArray	属性の配列を取得または設定します。(MemberDescriptor から継承されます。)
	NameHashCode	GetHashCode で指定されている、メンバの名前のハッシュ コードを取得します。(MemberDescriptor から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddValueChanged	プロパティが変更されたときに、ほかのオブジェクトに通知できるようにします。
	CanResetValue	派生クラスでオーバーライドされた場合、オブジェクトをリセットしたときに、そのオブジェクトの値が変化するかどうかを示す値を返します。
	Equals	オーバーロードされます。 オーバーライドされます。 プロパティ記述子を別のオブジェクトと比較して、等しいかどうかを確認します。
	GetChildProperties	オーバーロードされます。 PropertyDescriptorCollection を返します。
	GetEditor	指定した型のエディタを取得します。
	GetHashCode	オーバーライドされます。 このオブジェクトのハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetValue	派生クラスでオーバーライドされた場合、コンポーネントのプロパティの現在の値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RemoveValueChanged	プロパティが変更されたときに、ほかのオブジェクトに通知できるようにします。
	ResetValue	派生クラスでオーバーライドされた場合、コンポーネントのプロパティの値を既定値にリセットします。
	SetValue	派生クラスでオーバーライドされた場合、コンポーネントの値を別の値に設定します。
	ShouldSerializeValue	派生クラスでオーバーライドされた場合、プロパティの値を永続化する必要があるかどうかを示す値を決定します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	CreateAttributeCollection	コンストラクタに渡された属性配列を使用して、属性のコレクションを作成します。 (MemberDescriptor から継承されます。)
	CreateInstance	指定した型のインスタンスを作成します。
	FillAttributes	オーバーライドされます。 指定した親クラスの属性リストに PropertyDescriptor の属性を追加します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	FindMethod	オーバーロードされます。 指定したメソッドをリフレクションによって検索します。 (MemberDescriptor から継承されます。)
	GetInvocationTarget	オーバーライドされます。 このメソッドでは、メンバの呼び出し中に使用するオブジェクトが返されます。
	GetInvokee	メソッドを呼び出す対象のコンポーネントを取得します。 (MemberDescriptor から継承されます。)
	GetSite	指定したコンポーネントのコンポーネント サイトを取得します。 (MemberDescriptor から継承されます。)
	GetTypeFromName	型名を使用して型を返します。
	GetValueChangedHandler	特定のコンポーネントについて現在の ValueChanged イベント ハンドラ セットを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnValueChanged	実装した ValueChanged イベントを発生させます。

参照

関連項目

PropertyDescriptor クラス
System.ComponentModel 名前空間
MemberDescriptor クラス
Attribute
DefaultValueAttribute クラス