Package 類別

定義

命名空間:

Windows.ApplicationModel

提供套件的相關資訊。

public ref class Package sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Package final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Package

Public NotInheritable Class Package

繼承

Object Platform::Object IInspectable Package

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

重要

雖然未封裝的程式 (支援 Package 類別，但屬於缺少套件身分識別) 的應用程式的程式，但此類別的某些成員只會在 封裝 進程 (支援，也就是屬於 具有 套件身分識別) 的應用程式。 對於這些成員，主題的一節包含詳細資訊。 如需封裝的詳細資訊，請參閱 在 Visual Studio 中封裝桌面或 UWP 應用程式。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1607	14393	IsOptional
1607	14393	SignatureKind
1607	14393	VerifyContentIntegrityAsync
1703	15063	GetContentGroupAsync
1703	15063	GetContentGroupsAsync
1703	15063	SetInUseAsync
1703	15063	StageContentGroupsAsync (IEnumerable < String >)
1703	15063	StageContentGroupsAsync (IEnumerable < String > ，Boolean)
1809	17763	CheckUpdateAvailabilityAsync
1809	17763	GetAppInstallerInfo
1903	18362	EffectiveLocation
1903	18362	MutableLocation
2004	19041	EffectiveExternalLocation
2004	19041	EffectiveExternalPath
2004	19041	EffectivePath
2004	19041	GetAppListEntries
2004	19041	GetLogoAsRandomAccessStreamReference
2004	19041	InstalledPath
2004	19041	IsStub
2004	19041	MachineExternalLocation
2004	19041	MachineExternalPath
2004	19041	MutablePath
2004	19041	UserExternalLocation
2004	19041	UserExternalPath

屬性

Current	取得目前應用程式的套件。
Dependencies	取得目前封裝相依的封裝。
Description	取得封裝的描述。
DisplayName	取得封裝的顯示名稱。
EffectiveExternalLocation	根據應用程式安裝方式，取得目前套件套件資訊清單中指定的全電腦或每個使用者外部資料夾位置。
EffectiveExternalPath	根據應用程式安裝方式，取得目前套件套件資訊清單中指定的全電腦或每個使用者外部資料夾位置。
EffectiveLocation	根據應用程式是否在其套件資訊清單中宣告為可變動，取得已安裝之套件的已安裝資料夾或可變動資料夾的位置。
EffectivePath	根據應用程式是否在其套件資訊清單中宣告為可變動，取得已安裝之套件的已安裝資料夾或可變資料夾的路徑。
Id	取得目前封裝的套件識別。
InstallDate	僅Windows Phone。 取得在使用者的手機上安裝應用程式套件的日期。
InstalledDate	取得安裝應用程式封裝或上次更新的日期。
InstalledLocation	取得目前封裝之原始安裝資料夾中目前封裝的路徑。
InstalledPath	取得目前封裝之原始安裝資料夾中目前封裝的路徑。
IsBundle	指出套件是否為套件組合套件。
IsDevelopmentMode	指出套件是否安裝在開發模式中。
IsFramework	指出其他套件是否可以宣告此套件的相依性。
IsOptional	指出封裝是否為選擇性。
IsResourcePackage	指出封裝是否為資源套件。
IsStub	取得值，指出目前封裝中的應用程式是否為存根應用程式。
Logo	取得封裝的標誌。
MachineExternalLocation	取得目前封裝之封裝資訊清單中指定的全機器外部資料夾位置。
MachineExternalPath	取得目前封裝之封裝資訊清單中指定的全機器外部資料夾位置。
MutableLocation	如果應用程式在其套件資訊清單中宣告為可變動，則取得已安裝套件之可變資料夾中目前套件的路徑。
MutablePath	如果應用程式在其套件資訊清單中宣告為可變動，則取得已安裝套件之可變資料夾中目前套件的路徑。
PublisherDisplayName	取得封裝的發行者顯示名稱。
SignatureKind	如何簽署應用程式套件。
SourceUriSchemeName	包含用來安裝封裝之 URI 的配置部分。
Status	取得使用者的套件目前狀態。
UserExternalLocation	取得目前封裝之套件資訊清單中指定的每個使用者外部資料夾位置。
UserExternalPath	取得目前封裝之套件資訊清單中指定的每位使用者外部資料夾路徑。

方法

CheckUpdateAvailabilityAsync()	* CheckUpdateAvailabilityAsync 方法可讓開發人員檢查 .appinstaller 檔案中所列主要應用程式套件的更新。 它可讓開發人員判斷是否需要更新，因為 .appinstaller 原則。 這個方法目前僅適用于透過 .appinstaller 檔案安裝的應用程式。
FindRelatedPackages(FindRelatedPackagesOptions)	FindRelatedPackages方法會提供相依性，然後提供指定套件的相依性作為套件清單。 清單可以使用 options 參數，依相依性類型進行篩選。
GetAppInstallerInfo()	傳回 .appinstaller XML 檔案位置。 當您需要擷取應用程式的 .appinstaller XML 檔案位置時，請使用這個方法。 例如，如果您的應用程式需要將其相關聯的 .appinstaller 檔案共用 URI，這會很有用。 您可以選擇性地將引數新增至 URI。
GetAppListEntries()	列舉裝置上封裝的應用程式，並同步傳回清單。 只會傳回目前套件中包含的應用程式。
GetAppListEntriesAsync()	列舉裝置上的已封裝應用程式，並以非同步方式傳回清單。 只會傳回目前套件中包含的應用程式。
GetContentGroupAsync(String)	提供套件內容群組的相關資訊，例如其狀態、名稱、是否需要等等。
GetContentGroupsAsync()	提供應用程式中的所有套件內容群組及其狀態、名稱、是否需要等資訊。
GetLogoAsRandomAccessStreamReference(Size)	取得封裝的應用程式標誌做為隨機存取資料流程。
GetThumbnailToken()	僅Windows Phone。 傳回權杖，可用來擷取與此應用程式封裝相關聯的縮圖影像。
Launch(String)	僅Windows Phone。 啟動指定的應用程式。
SetInUseAsync(Boolean)	設定封裝是否正在使用中。
StageContentGroupsAsync(IIterable<String>)	將套件放在指定的內容群組中，放入暫存佇列中。
StageContentGroupsAsync(IIterable<String>, Boolean)	將套件放在指定的內容群組中，放入暫存佇列中;選擇性地將內容群組放在佇列的前端。
VerifyContentIntegrityAsync()	在載入之前，請確定套件尚未修改或竄改。

另請參閱

• Current
• PackageId
• 應用程式套件資訊範例
• 封裝應用程式