Freigeben über


ToolboxService.GetToolboxItems Methode

Definition

Gibt eine ICollection von ToolboxItem-Objekten zurück.

Überlädt

GetToolboxItems(Assembly, String, Boolean)

Gibt eine ICollection von ToolboxItem-Objekten für die angegebene Assembly zurück.

GetToolboxItems(AssemblyName, Boolean)

Gibt eine ICollection von ToolboxItem-Objekten für die angegebene Assembly zurück.

GetToolboxItems(AssemblyName)

Gibt eine ICollection von ToolboxItem-Objekten für die angegebene Assembly zurück.

GetToolboxItems(Assembly, String)

Gibt eine ICollection zurück, die alle Toolboxelemente in der angegebenen Assembly enthält.

GetToolboxItems(Assembly, String, Boolean)

Gibt eine ICollection von ToolboxItem-Objekten für die angegebene Assembly zurück.

public:
 static System::Collections::ICollection ^ GetToolboxItems(System::Reflection::Assembly ^ a, System::String ^ newCodeBase, bool throwOnError);
public static System.Collections.ICollection GetToolboxItems (System.Reflection.Assembly a, string newCodeBase, bool throwOnError);
static member GetToolboxItems : System.Reflection.Assembly * string * bool -> System.Collections.ICollection
Public Shared Function GetToolboxItems (a As Assembly, newCodeBase As String, throwOnError As Boolean) As ICollection

Parameter

a
Assembly

Die aufzulistende Assembly.

newCodeBase
String

Eine Zeichenfolge, die den Speicherort der Assembly als URL darstellt.

throwOnError
Boolean

true, um bei einem Fehler eine Ausnahme auszulösen, andernfalls false.

Gibt zurück

Eine Auflistung, die alle Toolboxelemente in der durch den angegebenen Assemblynamen dargestellten Assembly enthält.

Ausnahmen

a ist null.

Hinweise

Die GetToolboxItems -Methode durchsucht die Assembly nach allen Typen, die Toolboxelemente unterstützen, und gibt Elemente für diese Typen zurück. Um ein Toolboxelement zu unterstützen, muss ein Typ die folgenden Merkmale aufweisen:

  • Öffentlich sein.

  • Implementieren Sie IComponent.

  • Nicht abstrakt sein.

  • Der ToolboxItemAttribute Typ ist nicht auf false festgelegt.

  • Enthalten keine generischen Parameter.

Assemblys sind für die Dauer eines Prozesses gesperrt, sodass das Aufzählen verschiedener Dateien durch GetToolboxItems kann dazu führen, dass viele Assemblys geladen werden. Die GetToolboxItems Methoden, die einen Assemblynamen annehmen, erstellen eine separate AppDomain zum Durchsuchen von Assemblys. Wenn Sie das Aufzählen ToolboxItem von Objekten für eine Gruppe von Assemblys abgeschlossen haben, können Sie die UnloadToolboxItems -Methode aufrufen, die die AppDomain Dateiverweise für die geladenen Assemblys entladen und freigibt.

Gilt für:

GetToolboxItems(AssemblyName, Boolean)

Gibt eine ICollection von ToolboxItem-Objekten für die angegebene Assembly zurück.

public:
 static System::Collections::ICollection ^ GetToolboxItems(System::Reflection::AssemblyName ^ an, bool throwOnError);
public static System.Collections.ICollection GetToolboxItems (System.Reflection.AssemblyName an, bool throwOnError);
static member GetToolboxItems : System.Reflection.AssemblyName * bool -> System.Collections.ICollection
Public Shared Function GetToolboxItems (an As AssemblyName, throwOnError As Boolean) As ICollection

Parameter

an
AssemblyName

Ein Assemblyname, über den eine Assembly geladen werden soll.

throwOnError
Boolean

true, um bei einem Fehler eine Ausnahme auszulösen, andernfalls false.

Gibt zurück

Eine Auflistung, die alle Toolboxelemente in der durch den angegebenen Assemblynamen dargestellten Assembly enthält.

Ausnahmen

an ist null.

Hinweise

Die GetToolboxItems -Methode durchsucht die Assembly nach allen Typen, die Toolboxelemente unterstützen, und gibt Elemente für diese Typen zurück. Um ein Toolboxelement zu unterstützen, muss ein Typ die folgenden Merkmale aufweisen:

  • Öffentlich sein.

  • Implementieren Sie IComponent.

  • Nicht abstrakt sein.

  • Der ToolboxItemAttribute Typ ist nicht auf false festgelegt.

  • Enthalten keine generischen Parameter.

Assemblys sind für die Dauer eines Prozesses gesperrt, sodass das Aufzählen verschiedener Dateien durch GetToolboxItems kann dazu führen, dass viele Assemblys geladen werden. Die GetToolboxItems Methoden, die einen Assemblynamen annehmen, erstellen eine separate AppDomain zum Durchsuchen von Assemblys. Wenn Sie das Aufzählen ToolboxItem von Objekten für eine Gruppe von Assemblys abgeschlossen haben, können Sie die UnloadToolboxItems -Methode aufrufen, die die AppDomain Dateiverweise für die geladenen Assemblys entladen und freigibt.

Gilt für:

GetToolboxItems(AssemblyName)

Gibt eine ICollection von ToolboxItem-Objekten für die angegebene Assembly zurück.

public:
 static System::Collections::ICollection ^ GetToolboxItems(System::Reflection::AssemblyName ^ an);
public static System.Collections.ICollection GetToolboxItems (System.Reflection.AssemblyName an);
static member GetToolboxItems : System.Reflection.AssemblyName -> System.Collections.ICollection
Public Shared Function GetToolboxItems (an As AssemblyName) As ICollection

Parameter

an
AssemblyName

Ein Assemblyname, über den eine Assembly geladen werden soll.

Gibt zurück

Eine Auflistung, die alle Toolboxelemente in der durch den angegebenen Assemblynamen dargestellten Assembly enthält.

Ausnahmen

an ist null.

Hinweise

Die GetToolboxItems -Methode durchsucht die Assembly nach allen Typen, die Toolboxelemente unterstützen, und gibt Elemente für diese Typen zurück. Um ein Toolboxelement zu unterstützen, muss ein Typ die folgenden Merkmale aufweisen:

  • Öffentlich sein.

  • Implementieren Sie IComponent.

  • Nicht abstrakt sein.

  • Der ToolboxItemAttribute Typ ist nicht auf false festgelegt.

  • Enthalten keine generischen Parameter.

Assemblys sind für die Dauer eines Prozesses gesperrt, sodass das Aufzählen verschiedener Dateien durch GetToolboxItems kann dazu führen, dass viele Assemblys geladen werden. Die GetToolboxItems Methoden, die einen Assemblynamen annehmen, erstellen eine separate AppDomain zum Durchsuchen von Assemblys. Wenn Sie das Aufzählen ToolboxItem von Objekten für eine Gruppe von Assemblys abgeschlossen haben, können Sie die UnloadToolboxItems -Methode aufrufen, die die AppDomain Dateiverweise für die geladenen Assemblys entladen und freigibt.

Auf diese Weise geladene Assemblys werden in ein separates AppDomain geladen, sodass sie später entladen werden können. Dadurch wird die Assemblydatei nur vorübergehend gesperrt.

Weitere Informationen

Gilt für:

GetToolboxItems(Assembly, String)

Gibt eine ICollection zurück, die alle Toolboxelemente in der angegebenen Assembly enthält.

public:
 static System::Collections::ICollection ^ GetToolboxItems(System::Reflection::Assembly ^ a, System::String ^ newCodeBase);
public static System.Collections.ICollection GetToolboxItems (System.Reflection.Assembly a, string newCodeBase);
static member GetToolboxItems : System.Reflection.Assembly * string -> System.Collections.ICollection
Public Shared Function GetToolboxItems (a As Assembly, newCodeBase As String) As ICollection

Parameter

a
Assembly

Die aufzulistende Assembly.

newCodeBase
String

Eine Zeichenfolge, die den Speicherort der Assembly als URL darstellt.

Gibt zurück

Eine Auflistung, die alle Toolboxelemente in der angegebenen Assembly enthält.

Ausnahmen

a ist null.

Hinweise

Die GetToolboxItems -Methode durchsucht die Assembly nach allen Typen, die Toolboxelemente unterstützen, und gibt Elemente für diese Typen zurück. Um ein Toolboxelement zu unterstützen, muss ein Typ die folgenden Merkmale aufweisen:

  • Öffentlich sein.

  • Implementieren Sie IComponent.

  • Nicht abstrakt sein.

  • Der ToolboxItemAttribute Typ ist nicht auf false festgelegt.

  • Enthalten keine generischen Parameter.

Assemblys sind für die Dauer eines Prozesses gesperrt, sodass das Aufzählen verschiedener Dateien durch GetToolboxItems kann dazu führen, dass viele Assemblys geladen werden. Die GetToolboxItems Methoden, die einen Assemblynamen annehmen, erstellen eine separate AppDomain zum Durchsuchen von Assemblys. Wenn Sie das Aufzählen ToolboxItem von Objekten für eine Gruppe von Assemblys abgeschlossen haben, können Sie die UnloadToolboxItems -Methode aufrufen, die die AppDomain Dateiverweise für die geladenen Assemblys entladen und freigibt.

Weitere Informationen

Gilt für: