ToolboxItemContainer Classe

Definição

Encapsula um ToolboxItem.

public ref class ToolboxItemContainer : System::Runtime::Serialization::ISerializable
[System.Serializable]
public class ToolboxItemContainer : System.Runtime.Serialization.ISerializable
[<System.Serializable>]
type ToolboxItemContainer = class
    interface ISerializable
Public Class ToolboxItemContainer
Implements ISerializable
Herança
ToolboxItemContainer
Atributos
Implementações

Observações

ToolboxItemContainer é uma classe simples que encapsula um ToolboxItem para eficiência. Ao ter uma única classe que está sempre carregada, pode adiar o carregamento até ToolboxItem que seja necessário. Como novas classes podem ser derivadas de ToolboxItem, pode-se carregar um ToolboxItem que pode, por sua vez, carregar um assembly que ainda não está em memória. Para uma grande coleção de ToolboxItem objetos, isto pode causar o carregamento de um grande número de assemblies, o que diminui o desempenho. Em vez disso, o serviço toolbox lida apenas com ToolboxItemContainer objetos e recupera os seus contidos ToolboxItem apenas quando necessário.

O ToolboxItemContainer é concebido para armazenar quaisquer dados em cache do ToolboxItem. A implementação padrão apenas mantém o filtro do ToolboxItem, mas as classes derivadoras podem optar por armazenar em cache o nome, a imagem e outras informações. Os objetos ToolboxItemContainer suportam duas formas de serialização: podem ser serializados através da serialização em tempo de execução padrão, e também podem carregar e guardar a si próprios de um System.Windows.Forms.IDataObject. O primeiro oferece uma forma muito fácil de guardar ToolboxItemContainer objetos num armazenamento persistente. Este último oferece uma forma de integrar ToolboxItemContainer objetos com formatos mistos de armazenamento de dados.

Construtores

Name Description
ToolboxItemContainer(IDataObject)

Inicializa uma nova instância da ToolboxItemContainer classe a partir de um IDataObject.

ToolboxItemContainer(SerializationInfo, StreamingContext)

Inicializa uma nova instância da ToolboxItemContainer classe a partir de um fluxo de serialização.

ToolboxItemContainer(ToolboxItem)

Inicializa uma nova instância da ToolboxItemContainer classe a partir de um ToolboxItem.

Propriedades

Name Description
IsCreated

Recebe um valor que indica se o item subjacente da caixa de ferramentas foi desserializado.

IsTransient

Obtém um valor que indica se o ToolboxItem contido em é ToolboxItemContainer transitório.

ToolboxData

Obtém um IDataObject que descreve isto ToolboxItemContainer.

Métodos

Name Description
Equals(Object)

Determina se duas ToolboxItemContainer instâncias são iguais.

GetFilter(ICollection)

Devolve uma coleção de ToolboxItemFilterAttribute objetos que representam o filtro atual para o ToolboxItem.

GetHashCode()

Devolve o código de hash para esta instância.

GetObjectData(SerializationInfo, StreamingContext)

Guarda o estado de serialização do objeto.

GetToolboxItem(ICollection)

Devolve o ToolboxItem contido no ToolboxItemContainer.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
UpdateFilter(ToolboxItem)

Funde o filtro do recipiente com o filtro do item dado.

Implementações de Interface Explícita

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Para uma descrição deste elemento, veja o GetObjectData(SerializationInfo, StreamingContext) método.

Aplica-se a

Ver também