DesignerAttribute

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

DesignerAttribute クラス

コンポーネントに対するデザイン時サービスを実装するために使用するクラスを指定します。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Interface,
 AllowMultiple:=True, Inherited:=True)> _
Public NotInheritable Class
 DesignerAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As DesignerAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface, AllowMultiple=true,
 Inherited=true)] 
public sealed class DesignerAttribute : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Interface, AllowMultiple=true,
 Inherited=true)] 
public ref class DesignerAttribute sealed :
 public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface,
 AllowMultiple=true, Inherited=true) */ 
public final class DesignerAttribute extends
 Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Interface, AllowMultiple=true,
 Inherited=true) 
public final class DesignerAttribute extends
 Attribute

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

デザイナの基本型を検索するには、DesignerBaseTypeName プロパティを使用します。このメンバと関連付けられたデザイナの型名を取得するには、DesignerTypeName プロパティを使用します。

詳細については、属性の概要、属性を使用したメタデータの拡張 の各トピックを参照してください。

使用例

MyForm というクラスを作成する方法を次の例に示します。MyForm には、このクラスが DocumentDesigner を使用することを指定する DesignerAttribute と、Form カテゴリを指定する DesignerCategoryAttribute という 2 つの属性があります。

Visual Basic

<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL",
 _
    GetType(IRootDesigner)), DesignerCategory("Form")>
 _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class 'MyForm

C#

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL"
,
 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]
public class MyForm : ContainerControl {
    // Insert code here.
}

C++

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design.DLL"
,
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};

J#

/** @attribute Designer("System.Windows.Forms.Design.DocumentDesigner,"+
    "System.Windows.Forms.Design.DLL", IRootDesigner.class)
    @attribute DesignerCategory("Form")
 */
public static class MyForm
 extends ContainerControl
{
    // Insert code here.
} //MyForm

MyForm のインスタンスを作成する例を次に示します。そのクラスの属性を取得し、DesignerAttribute を抽出してから、デザイナの名前を出力します。

Visual Basic

Public Shared Function Main()
 As Integer
    ' Creates a new form.
    Dim myNewForm As New
 MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection =
 TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the DesignerAttribute
    ' from the AttributeCollection. 
    Dim myAttribute As DesignerAttribute =
 _
        CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    Console.WriteLine(("The designer for this class is: "
 & myAttribute.DesignerTypeName))
    
    Return 0
End Function 'Main

C#

public static int Main()
 {
    // Creates a new form.
    MyForm myNewForm = new MyForm();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);
 
    /* Prints the name of the designer by retrieving the DesignerAttribute
     * from the AttributeCollection. */
    DesignerAttribute myAttribute = 
       (DesignerAttribute)attributes[typeof(DesignerAttribute)];
    Console.WriteLine("The designer for this
 class is: " + myAttribute.DesignerTypeName);
  
    return 0;
}

C++

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the DesignerAttribute
       * from the AttributeCollection. */
   DesignerAttribute^ myAttribute = dynamic_cast<DesignerAttribute^>(attributes[
 DesignerAttribute::typeid ]);
   Console::WriteLine( "The designer for this
 class is: {0}", myAttribute->DesignerTypeName );
   return 0;
}

J#

public static void main(String[]
 args)
{
    // Creates a new form.
    MyForm myNewForm = new MyForm();

    // Gets the attributes for the collection.
    AttributeCollection attributes = 
        TypeDescriptor.GetAttributes(myNewForm);

    /* Prints the name of the designer by retrieving the 
       DesignerAttribute from the AttributeCollection. 
     */
    DesignerAttribute myAttribute = (DesignerAttribute)(
        attributes.get_Item(DesignerAttribute.class.ToType()));

    Console.WriteLine(("The designer for this
 class is: " 
        + myAttribute.get_DesignerTypeName()));
} //main

継承階層

System.Object
   System.Attribute
    System.ComponentModel.DesignerAttribute

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
DesignerAttribute メンバ
System.ComponentModel 名前空間
Attribute

DesignerAttribute コンストラクタ (Type)

デザイン時サービスを提供する型を指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    designerType As Type _
)

Visual Basic (使用法)

Dim designerType As Type

Dim instance As New DesignerAttribute(designerType)

C#

public DesignerAttribute (
    Type designerType
)

C++

public:
DesignerAttribute (
    Type^ designerType
)

J#

public DesignerAttribute (
    Type designerType
)

JScript

public function DesignerAttribute (
    designerType : Type
)

パラメータ

designerType

この属性がバインドされているコンポーネントに対してデザイン時サービスを提供するクラスを表す Type。

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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

DesignerAttribute コンストラクタ (String, Type)

デザイナ クラスの名前とデザイナの基本クラスを指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    designerTypeName As String, _
    designerBaseType As Type _
)

Visual Basic (使用法)

Dim designerTypeName As String
Dim designerBaseType As Type

Dim instance As New DesignerAttribute(designerTypeName,
 designerBaseType)

C#

public DesignerAttribute (
    string designerTypeName,
    Type designerBaseType
)

C++

public:
DesignerAttribute (
    String^ designerTypeName, 
    Type^ designerBaseType
)

J#

public DesignerAttribute (
    String designerTypeName, 
    Type designerBaseType
)

JScript

public function DesignerAttribute (
    designerTypeName : String, 
    designerBaseType : Type
)

パラメータ

designerTypeName

この属性がバインドされているコンポーネントに対してデザイン時サービスを提供する型の完全修飾名の連結、および、格納されているこの型のアセンブリの名前。

designerBaseType

designerTypeName と関連付ける基本クラスを表す Type。

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

designerBaseType パラメータを使用すると、特定のクラスに対して複数の型のデザイナを結び付けることができます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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

DesignerAttribute コンストラクタ (String)

デザイン時サービスを提供する型の名前を指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    designerTypeName As String _
)

Visual Basic (使用法)

Dim designerTypeName As String

Dim instance As New DesignerAttribute(designerTypeName)

C#

public DesignerAttribute (
    string designerTypeName
)

C++

public:
DesignerAttribute (
    String^ designerTypeName
)

J#

public DesignerAttribute (
    String designerTypeName
)

JScript

public function DesignerAttribute (
    designerTypeName : String
)

パラメータ

designerTypeName

この属性がバインドされているコンポーネントに対してデザイン時サービスを提供する型の完全修飾名の連結、および、格納されているこの型のアセンブリの名前。

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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

DesignerAttribute コンストラクタ

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

名前	説明
DesignerAttribute (String)	デザイン時サービスを提供する型の名前を指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。
DesignerAttribute (Type)	デザイン時サービスを提供する型を指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。
DesignerAttribute (String, String)	デザイナの型とデザイナの基本クラスを指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。
DesignerAttribute (String, Type)	デザイナ クラスの名前とデザイナの基本クラスを指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。
DesignerAttribute (Type, Type)	デザイナの型とデザイナ基本クラスを指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。

参照

関連項目

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

DesignerAttribute コンストラクタ (Type, Type)

デザイナの型とデザイナ基本クラスを指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    designerType As Type, _
    designerBaseType As Type _
)

Visual Basic (使用法)

Dim designerType As Type
Dim designerBaseType As Type

Dim instance As New DesignerAttribute(designerType,
 designerBaseType)

C#

public DesignerAttribute (
    Type designerType,
    Type designerBaseType
)

C++

public:
DesignerAttribute (
    Type^ designerType, 
    Type^ designerBaseType
)

J#

public DesignerAttribute (
    Type designerType, 
    Type designerBaseType
)

JScript

public function DesignerAttribute (
    designerType : Type, 
    designerBaseType : Type
)

パラメータ

designerType

この属性がバインドされているコンポーネントに対してデザイン時サービスを提供するクラスを表す Type。

designerBaseType

designerType と関連付ける基本クラスを表す Type。

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

designerBaseType パラメータを使用すると、特定のクラスに対して複数の型のデザイナを結び付けることができます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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

DesignerAttribute コンストラクタ (String, String)

デザイナの型とデザイナの基本クラスを指定して、DesignerAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    designerTypeName As String, _
    designerBaseTypeName As String _
)

Visual Basic (使用法)

Dim designerTypeName As String
Dim designerBaseTypeName As String

Dim instance As New DesignerAttribute(designerTypeName,
 designerBaseTypeName)

C#

public DesignerAttribute (
    string designerTypeName,
    string designerBaseTypeName
)

C++

public:
DesignerAttribute (
    String^ designerTypeName, 
    String^ designerBaseTypeName
)

J#

public DesignerAttribute (
    String designerTypeName, 
    String designerBaseTypeName
)

JScript

public function DesignerAttribute (
    designerTypeName : String, 
    designerBaseTypeName : String
)

パラメータ

designerTypeName

この属性がバインドされているコンポーネントに対してデザイン時サービスを提供する型の完全修飾名の連結、および、格納されているこの型のアセンブリの名前。

designerBaseTypeName

デザイナ クラスと関連付ける基本クラスの完全修飾名。

解説

デザイン時サービスに使用するクラスは、IDesigner インターフェイスを実装している必要があります。

designerBaseTypeName パラメータを使用すると、特定のクラスに対して複数の型のデザイナを結び付けることができます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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

DesignerAttribute プロパティ

パブリック プロパティ

	名前	説明
	DesignerBaseTypeName	このデザイナの基本型の名前を取得します。
	DesignerTypeName	このデザイナ属性と関連付けられているデザイナ型の名前を取得します。
	TypeId	オーバーライドされます。 この属性型の一意の ID を取得します。

参照

関連項目

DesignerAttribute クラス
System.ComponentModel 名前空間
Attribute

DesignerAttribute メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトの値が現在の DesignerAttribute と等しいかどうかを示す値を返します。
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	オーバーライドされます。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

DesignerAttribute クラス
System.ComponentModel 名前空間
Attribute

DesignerAttribute メンバ

コンポーネントに対するデザイン時サービスを実装するために使用するクラスを指定します。

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

パブリック コンストラクタ

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

パブリック プロパティ

	名前	説明
	DesignerBaseTypeName	このデザイナの基本型の名前を取得します。
	DesignerTypeName	このデザイナ属性と関連付けられているデザイナ型の名前を取得します。
	TypeId	オーバーライドされます。 この属性型の一意の ID を取得します。

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトの値が現在の DesignerAttribute と等しいかどうかを示す値を返します。
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	オーバーライドされます。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

DesignerAttribute クラス
System.ComponentModel 名前空間
Attribute