Package.MachineExternalLocation Property

Definition

Namespace:

Windows.ApplicationModel

Gets the location of the machine-wide external folder specified in the package manifest for the current package.

public:
 property StorageFolder ^ MachineExternalLocation { StorageFolder ^ get(); };

StorageFolder MachineExternalLocation();

public StorageFolder MachineExternalLocation { get; }

var storageFolder = package.machineExternalLocation;

Public ReadOnly Property MachineExternalLocation As StorageFolder

Property Value

StorageFolder

The location of the machine-wide external folder specified in the package manifest for the current package.

Windows requirements

Device family	Windows 10, version 2004 (introduced in 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v10.0)

Remarks

The external folder is a disk location outside of the package where the package manifest can reference application content. This property returns the location of the external folder as a StorageFolder object for an app that is provisioned for all users on the machine.

This property is intended to be used when you are granting package identity by packaging with external location. A package with external location contains only a package manifest (not an executable or other application content). The package manifest references application content in an external disk location outside of the package.

To set the external folder, use one of the following combinations of PackageManager methods and related options properties:

• AddPackageByUriAsync: Set the ExternalLocationUri property of the options parameter.
• RegisterPackageByUriAsync: Set the ExternalLocationUri property of the options parameter.
• StagePackageByUriAsync: Set the ExternalLocationUri property of the options parameter.

See also

• AddPackageByUriAsync(Uri, AddPackageOptions)
• RegisterPackageByUriAsync(Uri, RegisterPackageOptions)
• StagePackageByUriAsync(Uri, StagePackageOptions)