ToolboxItemContainer Classe

Definição

Encapsula um ToolboxItem.Encapsulates a ToolboxItem.

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

Comentários

ToolboxItemContaineré uma classe simples que encapsula um ToolboxItem para obter eficiência.ToolboxItemContainer is a simple class that encapsulates a ToolboxItem for efficiency. Tendo uma única classe sempre carregada, você pode adiar o carregamento do ToolboxItem até que seja necessário.By having a single class that is always loaded, you can defer the loading of the ToolboxItem until it is needed. Como novas classes podem ser derivadas de ToolboxItem, você pode carregar um ToolboxItem que poderia, por sua vez, carregar um assembly que ainda não esteja na memória.Because new classes can be derived from ToolboxItem, you could load a ToolboxItem that could, in turn, load an assembly that is not already in memory. Para uma grande coleção de ToolboxItem objetos, isso pode fazer com que um grande número de assemblies seja carregado, o que diminui o desempenho.For a large collection of ToolboxItem objects, this could cause a large number of assemblies to be loaded, which decreases performance. Em vez disso, o serviço caixa de ToolboxItemContainer ferramentas lida apenas com objetos ToolboxItem e recupera seus contidos somente quando necessário.Instead, the toolbox service deals only with ToolboxItemContainer objects and retrieves their contained ToolboxItem only when necessary.

O ToolboxItemContainer é projetado para armazenar todos os dados armazenados em cache ToolboxItemdo.The ToolboxItemContainer is designed to hold any cached data from the ToolboxItem. A implementação padrão só mantém o filtro do ToolboxItem, mas derivar classes pode optar por armazenar em cache o nome, a imagem e outras informações.The default implementation only holds the filter of the ToolboxItem, but deriving classes may choose to cache the name, image, and other information. ToolboxItemContaineros objetos dão suporte a duas formas de serialização: elas podem ser serializadas por meio da serialização de tempo de execução padrão e também System.Windows.Forms.IDataObjectpodem ser carregadas e salvas a partir de um.ToolboxItemContainer objects support two forms of serialization: they can be serialized through standard runtime serialization, and they can also load and save themselves from a System.Windows.Forms.IDataObject. O primeiro fornece uma maneira muito fácil de salvar ToolboxItemContainer objetos em um armazenamento persistente.The former provides a very easy way to save ToolboxItemContainer objects to a persistent storage. O último fornece uma maneira de integrar ToolboxItemContainer objetos com formatos de armazenamento de dados mistos.The latter provides a way to integrate ToolboxItemContainer objects with mixed data storage formats.

Construtores

ToolboxItemContainer(IDataObject)

Inicializa uma nova instância da classe ToolboxItemContainer de um IDataObject.Initializes a new instance of the ToolboxItemContainer class from a IDataObject.

ToolboxItemContainer(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe ToolboxItemContainer de um fluxo de serialização.Initializes a new instance of the ToolboxItemContainer class from a serialization stream.

ToolboxItemContainer(ToolboxItem)

Inicializa uma nova instância da classe ToolboxItemContainer de um ToolboxItem.Initializes a new instance of the ToolboxItemContainer class from a ToolboxItem.

Propriedades

IsCreated

Obtém um valor que indica se o item de caixa de ferramentas subjacente foi desserializado.Gets a value indicating whether the underlying toolbox item has been deserialized.

IsTransient

Obtém um valor que indica se o ToolboxItem contido no ToolboxItemContainer é transitório.Gets a value indicating if the ToolboxItem contained in the ToolboxItemContainer is transient.

ToolboxData

Obtém um IDataObject que descreve esse ToolboxItemContainer.Gets an IDataObject that describes this ToolboxItemContainer.

Métodos

Equals(Object)

Determina se duas instâncias ToolboxItemContainer são iguais.Determines whether two ToolboxItemContainer instances are equal.

GetFilter(ICollection)

Retorna uma coleção de objetos ToolboxItemFilterAttribute que representa o filtro atual do ToolboxItem.Returns a collection of ToolboxItemFilterAttribute objects that represent the current filter for the ToolboxItem.

GetHashCode()

Retorna o código hash para essa instância.Returns the hash code for this instance.

GetObjectData(SerializationInfo, StreamingContext)

Salva o estado de serialização do objeto.Saves the serialization state for the object.

GetToolboxItem(ICollection)

Retorna o ToolboxItem contido no ToolboxItemContainer.Returns the ToolboxItem contained in the ToolboxItemContainer.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UpdateFilter(ToolboxItem)

Mescla o filtro do contêiner com o filtro do item fornecido.Merges the container's filter with the filter from the given item.

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Para obter uma descrição desse membro, consulte o método GetObjectData(SerializationInfo, StreamingContext).For a description of this member, see the GetObjectData(SerializationInfo, StreamingContext) method.

Aplica-se a

Veja também