NestedContainer Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Zdroj:

NestedContainer.cs

Poskytuje základní implementaci rozhraní INestedContainer , která umožňuje kontejnerům mít vlastnící komponentu.

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

public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.IContainer, System.ComponentModel.INestedContainer

type NestedContainer = class
    inherit Container
    interface IContainer
    interface IDisposable
    interface INestedContainer

Public Class NestedContainer
Inherits Container
Implements IContainer, IDisposable, INestedContainer

Dědičnost

Object

Container

NestedContainer

Implementuje

IContainer INestedContainer IDisposable

Poznámky

Třída NestedContainer je jednoduchá implementace INestedContainer rozhraní, která definuje komponentu, která logicky obsahuje nula nebo více dalších komponent a je vlastněna nadřazenou komponentou. Chování vnořených kontejnerů se liší od standardu Container mnoha způsoby, včetně následujících:

• Charakteristiky lokality, jako DesignMode jsou a GetService jsou směrovány přes lokalitu vlastnící součásti.

• Vlastnost webu Name je kvalifikovaný název, který zahrnuje název vlastnící součásti následovaný tečkou (.) a názvem podřízené komponenty.

• GetService poskytuje podporu pro INestedContainer službu.

• Když je vlastnící komponenta odstraněna, kontejner je také uvolněn.

Návrháři navíc zachází s vnořenými kontejnery odlišně. Hostitel návrháře se zajímá jenom o jeden kontejner – ten, který je přidružený k hostiteli. Proto se události přidání a odebrání komponenty nevyvolají, když je komponenta přidána nebo odebrána z vnořeného kontejneru. Vzhledem k tomu, že služby procházejí do vnořeného kontejneru, jsou události změn komponent vyvolány při změně komponenty v vnořeného kontejneru.

Tato rozdílnost sledování událostí má vliv také na funkci vrácení zpět, která je úzce svázaná se serializací. Standardní modul pro vrácení zpět používá IReferenceService ke sledování změn provedených komponentami. Pokud modul pro vrácení zpět nemůže identifikovat název komponenty prostřednictvím referenční služby, modul bude ignorovat všechny změny pro tuto komponentu. Tato služba automaticky rozpozná změny obsažených součástí pouze v případě, že jsou ve svých vlastnících zpřístupněny jako veřejné vlastnosti jen pro čtení stejného názvu. Jinak musí vývojář předat události změny komponent až do vlastníka. Pokud je například vlastnost vnořené komponenty Text znovu zobrazena ve svém vlastním komponentě jako Address vlastnost, při Text změně vlastnosti musí být změna vlastnosti provedena programově pro odpovídající Address vlastnost nebo jinak tato změna nebude sledována vrácením zpět.

Konstruktory

Name	Description
NestedContainer(IComponent)	Inicializuje novou instanci NestedContainer třídy.

Vlastnosti

Name	Description
Components	Získá všechny komponenty v souboru Container. (Zděděno od Container)
Owner	Získá vlastnící komponentu pro tento vnořený kontejner.
OwnerName	Získá název vlastnící komponenty.

Metody

Name	Description
Add(IComponent, String)	Přidá zadaný Component název Container a přiřadí ho jako název. (Zděděno od Container)
Add(IComponent)	Přidá zadanou Component hodnotu do .Container Komponenta není pojmenována. (Zděděno od Container)
CreateSite(IComponent, String)	Vytvoří lokalitu pro komponentu v rámci kontejneru.
Dispose()	Uvolní všechny prostředky používané nástrojem Container. (Zděděno od Container)
Dispose(Boolean)	Uvolní prostředky používané vnořeným kontejnerem.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetService(Type)	Získá objekt služby zadaného typu, pokud je k dispozici.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Remove(IComponent)	Odebere součást z objektu Container. (Zděděno od Container)
RemoveWithoutUnsiting(IComponent)	Odebere komponentu Container z nastavení bez nastavení Site na null. (Zděděno od Container)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
ValidateName(IComponent, String)	Určuje, zda je název komponenty pro tento kontejner jedinečný. (Zděděno od Container)

Viz také

• INestedContainer
• IContainer
• ISite
• IReferenceService