AddInToken.Activate(Of T) Method (AddInSecurityLevel)

 

Activates an add-in with a specified trust level in a new application domain.

Namespace:   System.AddIn.Hosting
Assembly:  System.AddIn (in System.AddIn.dll)

Public Function Activate(Of T) (
	trustLevel As AddInSecurityLevel
) As T

Parameters

trustLevel
Type: System.AddIn.Hosting.AddInSecurityLevel

One of the enumeration values that specifies the trust level.

Return Value

Type: T

The host view of the add-in.

Type Parameters

T

The interface or abstract base type that represents the host view of the add-in.

This method overload loads the add-in into an automatically generated application domain. If you want to specify a name for the new application domain, use the Activate(Of T)(AddInSecurityLevel, String) overload.

This method sets the base directory for the application domain to be the location of the add-in assembly. It also looks for the configuration file [addinassemblyname].dll.config and, if found, sets it to be the configuration file for the new application domain.

The following example shows how to activate an add-in, identified by the chosen token, in an automatically generated application domain with a specified security level.

'Ask the user which add-in they would like to use.
Dim selectedToken As AddInToken = ChooseAddIn(tokens)
'Activate the selected AddInToken in a new
'application domain with the Internet trust level.
Dim CalcAddIn As Calculator = selectedToken.Activate(Of Calculator)(AddInSecurityLevel.Internet)
'Run the add-in using a custom method.
RunCalculator(CalcAddIn)

.NET Framework
Available since 3.5
Return to top
Show: