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