IExtensionManager Interface
Loads extensions and uses the extensions’ factories to provide services.
Methods
| Method | Description |
|---|---|
| Add(extensionAssembly) | Adds an extension assembly directly to the manager. |
| GetCacheLocations() | Gets extensions cache locations. |
| GetExtensionPackageRootFolderName() | Gets the root folder name used in extension’s package. |
| Load(extensionReference) | Loads an extension assembly from an extension reference string. |
WixToolset.Extensibility.dll version 5.0.0+41e11442b2ca93e444b60213b5ae99dcbab787d8 |
Add(extensionAssembly) Method {#add_extensionassembly}
Adds an extension assembly directly to the manager.
Declaration
public void Add( System.Reflection.Assembly extensionAssembly)Parameters
| Parameter | Type | Description |
|---|---|---|
| extensionAssembly | System.Reflection.Assembly | Extension assembly. |
GetCacheLocations() Method {#getcachelocations_nop}
Gets extensions cache locations.
Declaration
public System.Collections.Generic.IReadOnlyCollection<WixToolset.Extensibility.Data.IExtensionCacheLocation> GetCacheLocations()Return value
System.Collections.Generic.IReadOnlyCollection<WixToolset.Extensibility.Data.IExtensionCacheLocation> List of cache locations where extensions may be found.
GetExtensionPackageRootFolderName() Method {#getextensionpackagerootfoldername_nop}
Gets the root folder name used in extension’s package.
Declaration
public string GetExtensionPackageRootFolderName()Return value
string Root folder name to find extension in a package.
Load(extensionReference) Method {#load_extensionreference}
Loads an extension assembly from an extension reference string.
Declaration
public void Load( string extensionReference)Parameters
| Parameter | Type | Description |
|---|---|---|
| extensionReference | string | Reference to the extension. |
Return value
void The loaded assembly. This assembly can be ignored since the extension manager maintains the list of loaded assemblies internally.
Remarks
extensionReference can be in several different forms:
- Full path to an extension file (C:\MyExtensions\MyExtension.Example.wixext.dll):
- Reference to latest version of an extension in the cache (MyExtension.Example.wixext):
- Versioned reference to specific extension in the cache (MyExtension.Example.wixext/1.0.2):
- Relative path to an extension file (…\MyExtensions\MyExtension.Example.wixext.dll):