Edit

Share via


AddInSecurityLevel Enum

Definition

Specifies the trust level that is granted to the application domain that an add-in is loaded into.

public enum class AddInSecurityLevel
[System.Serializable]
public enum AddInSecurityLevel
[<System.Serializable>]
type AddInSecurityLevel = 
Public Enum AddInSecurityLevel
Inheritance
AddInSecurityLevel
Attributes

Fields

Name Value Description
Internet 0

Use the Internet security level for add-ins that have a low trust level.

Intranet 1

Use the Intranet security level for add-ins that are located on a company's intranet. These add-ins can have a greater trust level because the servers and information are within a company's firewall.

FullTrust 2

Use the full trust security level for add-ins that are allowed to read and write to the local file system, create network connections, and read from the registry. This security level grants full access to the add-in's code access security (CAS) by applying the Unrestricted field.

Host 3

Use the host security level to give the add-in the same permissions currently granted to the hosting code. This setting has two purposes:

- It represents the maximum permission set a host can grant to its add-ins.

- It allows a ClickOnce or an Extensible Application Markup Language (XAML) Browser Application (XBAP) host to propagate its site of origin to its add-ins, which enables them to contact the server.

Examples

The following example activates an add-in with a specified trust level.

//Ask the user which add-in they would like to use.
AddInToken selectedToken = ChooseAddIn(tokens);

//Activate the selected AddInToken in a new
//application domain with the Internet trust level.
Calculator CalcAddIn = selectedToken.Activate<Calculator>(AddInSecurityLevel.Internet);

//Run the add-in using a custom method.
RunCalculator(CalcAddIn);
'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)

Remarks

The add-in system activates the add-in with the permission set that corresponds to the trust level specified for the add-in's application domain. That permission set is defined by the common language runtime's code access security (CAS) configuration.

The values of this enumeration cannot be combined by using the bitwise OR operation.

Applies to

See also