NestedContainer

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

NestedContainer クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

INestedContainer インターフェイスの基本実装を提供し、コンテナが所有コンポーネントを持つことができるようにします。

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

Visual Basic (宣言)

Public Class NestedContainer
    Inherits Container
    Implements INestedContainer, IContainer, IDisposable

Visual Basic (使用法)

Dim instance As NestedContainer

C#

public class NestedContainer : Container, INestedContainer,
 IContainer, IDisposable

C++

public ref class NestedContainer : public
 Container, INestedContainer, IContainer, IDisposable

J#

public class NestedContainer extends Container
 implements INestedContainer, IContainer, 
    IDisposable

JScript

public class NestedContainer extends
 Container implements INestedContainer, IContainer, 
    IDisposable

解説

NestedContainer クラスは、INestedContainer インターフェイスの単純な実装です。このクラスは、論理上 0 個以上の他のコンポーネントを格納し、親コンポーネントによって所有されるコンポーネントを定義します。入れ子になったコンテナの動作は、次のような多くの点で標準の Container とは異なります。

• DesignMode や GetService などのサイトの特性は、所有コンポーネントのサイトを介して伝達されます。

• サイトの Name プロパティは、所有コンポーネントの名前と、その後ろにピリオド (.) と子コンポーネントの名前が付く修飾名です。

• GetService は、サービスとして INestedContainer をサポートします。

• 所有コンポーネントが破棄されると、コンテナも破棄されます。

また、デザイナは入れ子になったコンテナを異なる方法で取り扱います。デザイナ ホストは、1 つのコンテナ (そのホストに関連付けられたコンテナ) のみを対象とします。したがって、入れ子になったコンテナにコンポーネントが追加されたり削除されたりしても、コンポーネントの追加イベントおよび削除イベントは発生しません。ただし、サービスは入れ子になったコンテナに流れるため、入れ子になったコンテナ内のコンポーネントが変更されると、コンポーネントの変更イベントが発生します。

イベント追跡におけるこの違いは、シリアル化と密接な関係がある元に戻す機能にも影響を与えます。標準のアンドゥ エンジンは、IReferenceService を使用して、コンポーネントに加えられた変更を追跡します。アンドゥ エンジンが参照サービスによってコンポーネントの名前を識別できない場合、エンジンはそのコンポーネントに加えられた変更をすべて無視します。このサービスは、格納されているコンポーネントがその所有コンポーネント内で同じ名前の読み取り専用のパブリック プロパティとして公開されている場合のみ、これらのコンポーネントに加えられた変更を自動的に認識します。それ以外の場合は、開発者がコンポーネントの変更イベントをその所有コンポーネントに渡す必要があります。たとえば、入れ子になったコンポーネントの Text プロパティが、その所有コンポーネントでは Address プロパティとして示される場合、Text プロパティが変更されると、対応する Address プロパティに対してプログラムによってプロパティ変更を行う必要があります。この処理を行わないと、アンドゥ エンジンはこの変更を追跡しません。

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

継承階層

System.Object
   System.ComponentModel.Container
    System.ComponentModel.NestedContainer

スレッド セーフ

この型の 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

参照

関連項目
NestedContainer メンバ
System.ComponentModel 名前空間
INestedContainer インターフェイス
IContainer インターフェイス
ISite インターフェイス
IReferenceService

NestedContainer コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public Sub New ( _
    owner As IComponent _
)

Visual Basic (使用法)

Dim owner As IComponent

Dim instance As New NestedContainer(owner)

C#

public NestedContainer (
    IComponent owner
)

C++

public:
NestedContainer (
    IComponent^ owner
)

J#

public NestedContainer (
    IComponent owner
)

JScript

public function NestedContainer (
    owner : IComponent
)

パラメータ

owner

この入れ子になったコンテナを所有している IComponent。

例外

例外の種類	条件
ArgumentNullException	owner が null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは所有者の Disposed イベントに参加し、入れ子になったコンテナの Dispose メソッドが自動的に呼び出されるようします。

プラットフォーム

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

参照

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

NestedContainer プロパティ

パブリック プロパティ

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

	名前	説明
	Components	Container 内のすべてのコンポーネントを取得します。 ( Container から継承されます。)
	Owner	この入れ子になったコンテナの所有コンポーネントを取得します。

プロテクト プロパティ

	名前	説明
	OwnerName	所有コンポーネントの名前を取得します。

参照

関連項目

NestedContainer クラス
System.ComponentModel 名前空間
INestedContainer インターフェイス
IContainer インターフェイス
ISite インターフェイス
IReferenceService

NestedContainer メソッド

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 Component を Container に追加します。 ( Container から継承されます。)
	Dispose	オーバーロードされます。 NestedContainer によって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	Container からコンポーネントを削除します。 ( Container から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	CreateSite	オーバーライドされます。 コンテナ内にコンポーネント用のサイトを作成します。
	Dispose	オーバーロードされます。 オーバーライドされます。 NestedContainer によって使用されているすべてのリソースを解放します。
	Finalize	Container がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Container から継承されます。)
	GetService	オーバーライドされます。 指定した型のサービス オブジェクトがある場合は、そのオブジェクトを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	RemoveWithoutUnsiting	Site に null 参照 (Visual Basic では Nothing) を設定しないで、Container からコンポーネントを削除します。 ( Container から継承されます。)
	ValidateName	コンポーネント名がこのコンテナで一意であるかどうかを判断します。 ( Container から継承されます。)

参照

関連項目

NestedContainer クラス
System.ComponentModel 名前空間
INestedContainer インターフェイス
IContainer インターフェイス
ISite インターフェイス
IReferenceService

NestedContainer メンバ

INestedContainer インターフェイスの基本実装を提供し、コンテナが所有コンポーネントを持つことができるようにします。

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

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

	名前	説明
	NestedContainer	NestedContainer クラスの新しいインスタンスを初期化します。

パブリック プロパティ

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

	名前	説明
	Components	Container 内のすべてのコンポーネントを取得します。(Container から継承されます。)
	Owner	この入れ子になったコンテナの所有コンポーネントを取得します。

プロテクト プロパティ

	名前	説明
	OwnerName	所有コンポーネントの名前を取得します。

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 Component を Container に追加します。 (Container から継承されます。)
	Dispose	オーバーロードされます。 NestedContainer によって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	Container からコンポーネントを削除します。 (Container から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	CreateSite	オーバーライドされます。 コンテナ内にコンポーネント用のサイトを作成します。
	Dispose	オーバーロードされます。 オーバーライドされます。 NestedContainer によって使用されているすべてのリソースを解放します。
	Finalize	Container がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Container から継承されます。)
	GetService	オーバーライドされます。 指定した型のサービス オブジェクトがある場合は、そのオブジェクトを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	RemoveWithoutUnsiting	Site に null 参照 (Visual Basic では Nothing) を設定しないで、Container からコンポーネントを削除します。 (Container から継承されます。)
	ValidateName	コンポーネント名がこのコンテナで一意であるかどうかを判断します。 (Container から継承されます。)

参照

関連項目

NestedContainer クラス
System.ComponentModel 名前空間
INestedContainer インターフェイス
IContainer インターフェイス
ISite インターフェイス
IReferenceService