WebControlToolboxItem Class

.NET Framework (current version)

Provides a base class for a Web server control ToolboxItem.

Namespace: System.Web.UI.Design
Assembly: System.Design (in System.Design.dll)

Inheritance Hierarchy

System::Object
System.Drawing.Design::ToolboxItem
System.Web.UI.Design::WebControlToolboxItem
System.Web.UI.Design::ExtenderControlToolboxItem

Syntax

C++

[SerializableAttribute]
[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::UnmanagedCode)]
public ref class WebControlToolboxItem : ToolboxItem

Constructors

	Name	Description
	WebControlToolboxItem()	Initializes a new instance of the WebControlToolboxItem class.
	WebControlToolboxItem(SerializationInfo^, StreamingContext)	Creates a new instance of the WebControlToolboxItem class using the provided SerializationInfo object and StreamingContext.
	WebControlToolboxItem(Type^)	Creates a new instance of the WebControlToolboxItem class using the provided type.

Properties

	Name	Description
	AssemblyName	Gets or sets the name of the assembly that contains the type or types that the toolbox item creates.(Inherited from ToolboxItem.)
	Bitmap	Gets or sets a bitmap to represent the toolbox item in the toolbox.(Inherited from ToolboxItem.)
	Company	Gets or sets the company name for this ToolboxItem.(Inherited from ToolboxItem.)
	ComponentType	Gets the component type for this ToolboxItem.(Inherited from ToolboxItem.)
	DependentAssemblies	Gets or sets the AssemblyName for the toolbox item.(Inherited from ToolboxItem.)
	Description	Gets or sets the description for this ToolboxItem.(Inherited from ToolboxItem.)
	DisplayName	Gets or sets the display name for the toolbox item.(Inherited from ToolboxItem.)
	Filter	Gets or sets the filter that determines whether the toolbox item can be used on a destination component.(Inherited from ToolboxItem.)
	IsTransient	Gets a value indicating whether the toolbox item is transient.(Inherited from ToolboxItem.)
	Locked	Gets a value indicating whether the ToolboxItem is currently locked.(Inherited from ToolboxItem.)
	OriginalBitmap	Gets or sets the original bitmap that will be used in the toolbox for this item.(Inherited from ToolboxItem.)
	Properties	Gets a dictionary of properties.(Inherited from ToolboxItem.)
	TypeName	Gets or sets the fully qualified name of the type of IComponent that the toolbox item creates when invoked.(Inherited from ToolboxItem.)
	Version	Gets the version for this ToolboxItem.(Inherited from ToolboxItem.)

Methods

	Name	Description
	CheckUnlocked()	Throws an exception if the toolbox item is currently locked.(Inherited from ToolboxItem.)
	CreateComponents()	Creates the components that the toolbox item is configured to create.(Inherited from ToolboxItem.)
	CreateComponents(IDesignerHost^)	Creates the components that the toolbox item is configured to create, using the specified designer host.(Inherited from ToolboxItem.)
	CreateComponents(IDesignerHost^, IDictionary^)	Creates the components that the toolbox item is configured to create, using the specified designer host and default values.(Inherited from ToolboxItem.)
	CreateComponentsCore(IDesignerHost^)	Creates objects from each type contained in this ToolboxItem, and adds them to the specified designer.(Overrides ToolboxItem::CreateComponentsCore(IDesignerHost^).)
	CreateComponentsCore(IDesignerHost^, IDictionary^)	Creates an array of components when the toolbox item is invoked.(Inherited from ToolboxItem.)
	Deserialize(SerializationInfo^, StreamingContext)	This API supports the product infrastructure and is not intended to be used directly from your code. Loads the state of the toolbox item from the specified serialization information object.(Overrides ToolboxItem::Deserialize(SerializationInfo^, StreamingContext).)
	Equals(Object^)	Determines whether two ToolboxItem instances are equal.(Inherited from ToolboxItem.)
	FilterPropertyValue(String^, Object^)	Filters a property value before returning it.(Inherited from ToolboxItem.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Returns the hash code for this instance.(Inherited from ToolboxItem.)
	GetToolAttributeValue(IDesignerHost^, Type^)	Gets the value of the specified type of attribute of the toolbox item.
	GetToolHtml(IDesignerHost^)	Gets the HTML for the Web control that the tool creates.
	GetToolType(IDesignerHost^)	Gets the type of this toolbox item.
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	GetType(IDesignerHost^)	Enables access to the type associated with the toolbox item.(Inherited from ToolboxItem.)
	GetType(IDesignerHost^, AssemblyName^, String^, Boolean)	Creates an instance of the specified type, optionally using a specified designer host and assembly name.(Inherited from ToolboxItem.)
	Initialize(Type^)	Initializes this toolbox item.(Overrides ToolboxItem::Initialize(Type^).)
	Lock()	Locks the toolbox item and prevents changes to its properties.(Inherited from ToolboxItem.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	OnComponentsCreated(ToolboxComponentsCreatedEventArgs^)	Raises the ComponentsCreated event.(Inherited from ToolboxItem.)
	OnComponentsCreating(ToolboxComponentsCreatingEventArgs^)	Raises the ComponentsCreating event.(Inherited from ToolboxItem.)
	Serialize(SerializationInfo^, StreamingContext)	This API supports the product infrastructure and is not intended to be used directly from your code. Saves the state of the toolbox item to the specified serialization information object.(Overrides ToolboxItem::Serialize(SerializationInfo^, StreamingContext).)
	ToString()	Returns a String that represents the current ToolboxItem.(Inherited from ToolboxItem.)
	ValidatePropertyType(String^, Object^, Type^, Boolean)	Validates that an object is of a given type.(Inherited from ToolboxItem.)
	ValidatePropertyValue(String^, Object^)	Validates a property before it is assigned to the property dictionary.(Inherited from ToolboxItem.)

Events

	Name	Description
	ComponentsCreated	Occurs immediately after components are created.(Inherited from ToolboxItem.)
	ComponentsCreating	Occurs when components are about to be created.(Inherited from ToolboxItem.)

Explicit Interface Implementations

	Name	Description
	ISerializable::GetObjectData(SerializationInfo^, StreamingContext)	For a description of this member, see the GetObjectData method.(Inherited from ToolboxItem.)

Remarks

WebControlToolboxItem provides a base class for toolbox items that create Web server controls. This class extends ToolboxItem and provides the following additional methods:

GetToolAttributeValue gets the value of an attribute of the toolbox item.
GetToolHtml gets the HTML that represents the initial state of the control.
GetToolType gets the type of the associated runtime component.

Version Information

.NET Framework
Available since 1.1

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.