AddInEnvironment Class

 

Provides access to the application domain and process of an add-in.

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

System.Object
  System.AddIn.Hosting.AddInEnvironment

public sealed class AddInEnvironment

NameDescription
System_CAPS_pubmethodAddInEnvironment(AppDomain)

Initializes a new instance of the AddInEnvironment class.

NameDescription
System_CAPS_pubpropertyProcess

Gets the AddInProcess object that represents the process in which the add-in is running.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

Use this class to load add-ins into a desired environment, which can be one of the following:

  • An existing application domain for which you have the AppDomain object.

  • An application domain that was automatically generated to activate an add-in.

  • An existing external process.

To obtain the AddInEnvironment object for an add-in, pass the add-in's application domain to the AddInEnvironment class constructor. Alternatively, you can use the AddInEnvironment property of the AddInController class to obtain the add-in's AddInEnvironment object.

After you obtain the AddInEnvironment object, you can do the following:

  • Pass that AddInEnvironment object to the appropriate Activate<T> method overload. The add-in will be activated in the application domain and process that is represented by the AddInEnvironment object.

  • Use the Process property to obtain an AddInProcess object. Then pass that object to the appropriate Activate<T> method overload. The add-in will be activated in the process that is represented by the AddInProcess object but in a new application domain.

.NET Framework
Available since 3.5

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

Return to top
Show: