ToolboxService.GetToolboxItems Method (Assembly, String, Boolean)


Returns an ICollection of ToolboxItem objects for the given assembly.

Namespace:   System.Drawing.Design
Assembly:  System.Drawing.Design (in System.Drawing.Design.dll)

public static ICollection GetToolboxItems(
	Assembly a,
	string newCodeBase,
	bool throwOnError


Type: System.Reflection.Assembly

The assembly to enumerate.

Type: System.String

A string that is the URL location of the assembly.

Type: System.Boolean

true to throw an exception on error; otherwise, false.

Return Value

Type: System.Collections.ICollection

A collection containing all the toolbox items in the assembly represented by the given assembly name.

Exception Condition

a is null.

The GetToolboxItems method scans the assembly for all types that support toolbox items, and return items for those types. To support a toolbox item, a type must have the following characteristics:

Assemblies are locked for the duration of a process, so enumerating various files through GetToolboxItems can cause many assemblies to be loaded. The GetToolboxItems methods that take an assembly name create a separate AppDomain to search assemblies. When you are finished enumerating ToolboxItem objects for a set of assemblies, you can call the UnloadToolboxItems method, which unloads the AppDomain and frees the file references on the loaded assemblies.

.NET Framework
Available since 2.0
Return to top