PackageManager.FindPackages 方法

參考

定義

命名空間:: Windows.Management.Deployment

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

FindPackages(String, String)	尋找具有指定名稱和發行者的所有已安裝套件。
FindPackages(String)	擷取所有使用者所安裝之指定套件系列的相關資訊。
FindPackages()	擷取所有使用者所安裝之指定套件系列的相關資訊。

FindPackages(String, String)

編輯

尋找具有指定名稱和發行者的所有已安裝套件。

public:
 virtual IIterable<Package ^> ^ FindPackages(Platform::String ^ packageName, Platform::String ^ packagePublisher) = FindPackages;

/// [Windows.Foundation.Metadata.Overload("FindPackagesByNamePublisher")]
IIterable<Package> FindPackages(winrt::hstring const& packageName, winrt::hstring const& packagePublisher);

[Windows.Foundation.Metadata.Overload("FindPackagesByNamePublisher")]
public IEnumerable<Package> FindPackages(string packageName, string packagePublisher);

function findPackages(packageName, packagePublisher)

Public Function FindPackages (packageName As String, packagePublisher As String) As IEnumerable(Of Package)

參數

packageName: String
Platform::String

winrt::hstring

封裝名稱。此參數不可為 Null。

packagePublisher: String
Platform::String

winrt::hstring

套件發行者。此參數不可為 Null。

傳回

IIterable<Package>

IEnumerable<Package>

如果方法成功，則會傳回具有相同封裝名稱和發行者名稱之封裝物件的可列舉集合。此集合中的每個 Package 物件都包含套件的相關資訊，包括但不限於其名稱、發行者、版本和安裝位置。如果找不到具有指定名稱和發行者的套件，這個方法會傳回空的清單。

屬性: OverloadAttribute

Windows 需求

應用程式功能

packageQuery

備註

這個方法需要系統管理許可權。

另請參閱

適用於

FindPackages(String)

編輯

擷取所有使用者所安裝之指定套件系列的相關資訊。

public:
 virtual IIterable<Package ^> ^ FindPackages(Platform::String ^ packageFamilyName) = FindPackages;

/// [Windows.Foundation.Metadata.Overload("FindPackagesByPackageFamilyName")]
IIterable<Package> FindPackages(winrt::hstring const& packageFamilyName);

[Windows.Foundation.Metadata.Overload("FindPackagesByPackageFamilyName")]
public IEnumerable<Package> FindPackages(string packageFamilyName);

function findPackages(packageFamilyName)

Public Function FindPackages (packageFamilyName As String) As IEnumerable(Of Package)

參數

packageFamilyName: String
Platform::String

winrt::hstring

套件系列名稱。此參數不可為 Null。

傳回

IIterable<Package>

IEnumerable<Package>

如果方法成功，將會傳回具有相同封裝系列名稱之封裝物件的可列舉集合。此集合中的每個 Package 物件都包含套件的相關資訊，包括但不限於其名稱、發行者、版本和安裝位置。如果找不到具有指定套件系列名稱的套件，這個方法會傳回空的清單。

屬性: OverloadAttribute

Windows 需求

應用程式功能

packageQuery

備註

這個方法需要系統管理許可權。 IIterable (Package) 集合中的每個套件都可以針對目前使用者或其他使用者安裝。此方法與 FindPackages (String packageName、String pulisherName) 方法不同。這裡的 packageFamilyName 參數是單一字串，由套件名稱和套件發行者雜湊所組成。

另請參閱

適用於

FindPackages()

編輯

擷取所有使用者所安裝之指定套件系列的相關資訊。

public:
 virtual IIterable<Package ^> ^ FindPackages() = FindPackages;

/// [Windows.Foundation.Metadata.Overload("FindPackages")]
IIterable<Package> FindPackages();

[Windows.Foundation.Metadata.Overload("FindPackages")]
public IEnumerable<Package> FindPackages();

function findPackages()

Public Function FindPackages () As IEnumerable(Of Package)

傳回

IIterable<Package>

IEnumerable<Package>

如果方法成功，則會傳回封裝物件的可列舉集合。此集合中的每個 Package 物件都包含套件的相關資訊，包括但不限於其名稱、發行者、版本和安裝位置。

屬性: OverloadAttribute

Windows 需求

應用程式功能

packageQuery

範例

此範例會使用 FindPackages () 來列舉所有使用者已安裝的套件。

using Windows.Management.Deployment;

public static int Main(string[] args)
{
    PackageManager packageManager = new PackageManager();

    IEnumerable<Windows.ApplicationModel.Package> packages = 
        (IEnumerable<Windows.ApplicationModel.Package>) packageManager.FindPackages();

    int packageCount = 0;
    foreach (var package in packages)
    {
        DisplayPackageInfo(package);

        packageCount += 1;
    }

    if (packageCount < 1)
    {
        Console.WriteLine("No packages were found.");
    }
}

private static void DisplayPackageInfo(Windows.ApplicationModel.Package package)
{
    Console.WriteLine("Name: {0}", package.Id.Name);

    Console.WriteLine("FullName: {0}", package.Id.FullName);

    Console.WriteLine("Version: {0}.{1}.{2}.{3}", package.Id.Version.Major, package.Id.Version.Minor,
        package.Id.Version.Build, package.Id.Version.Revision);

    Console.WriteLine("Publisher: {0}", package.Id.Publisher);

    Console.WriteLine("PublisherId: {0}", package.Id.PublisherId);

    Console.WriteLine("Installed Location: {0}", package.InstalledLocation.Path);

    Console.WriteLine("IsFramework: {0}", package.IsFramework);
}

另請參閱 C++/WinRT 的 Visual Studio 支援。

// main.cpp : In Visual Studio, create a new Windows Console Application (C++/WinRT), and run it (or run Visual Studio) as administrator.
#include "pch.h"

#include <winrt/Windows.ApplicationModel.h>
#include <winrt/Windows.Management.Deployment.h>
#include <winrt/Windows.Storage.h>
#include <iostream>

using namespace winrt;
using namespace Windows::ApplicationModel;
using namespace Windows::Management::Deployment;
using namespace Windows::Storage;

void DisplayPackageInfo(Windows::ApplicationModel::Package const& package)
{
    try
    {
        std::wcout << L"Name: " << package.Id().Name().c_str() << std::endl;
        std::wcout << L"FullName: " << package.Id().FullName().c_str() << std::endl;
        std::wcout << L"Version: " << package.Id().Version().Major << "." << package.Id().Version().Minor << "." << package.Id().Version().Build << "." << package.Id().Version().Revision << std::endl;
        std::wcout << L"Publisher: " << package.Id().Publisher().c_str() << std::endl;
        std::wcout << L"PublisherId: " << package.Id().PublisherId().c_str() << std::endl;
        std::wcout << L"Installed Location: " << package.InstalledLocation().Path().c_str() << std::endl;
        std::wcout << L"IsFramework: " << (package.IsFramework() ? L"True" : L"False") << std::endl;
    }
    catch (winrt::hresult_error const& ex)
    {
        std::wcout << ex.message().c_str() << std::endl;
    }
}

int wmain()
{
    winrt::init_apartment();

    bool noPackagesFound{ true };
    for (auto const& package : PackageManager{}.FindPackages())
    {
        DisplayPackageInfo(package);
        noPackagesFound = false;
    }

    if (noPackagesFound)
    {
        std::wcout << L"No packages were found." << std::endl;
    }

    return 0;
}

using namespace Windows::Management::Deployment;

[STAThread]
int __cdecl main(Platform::Array<String^>^ args)
{
    PackageManager^ packageManager = ref new PackageManager();

    IIterable<Windows::ApplicationModel::Package^>^ packages = packageManager->FindPackages(); 

    int packageCount = 0;
    std::for_each(Windows::Foundation::Collections::begin(packages), Windows::Foundation::Collections::end(packages), 
    [&](Windows::ApplicationModel::Package^ package) 
    {
        DisplayPackageInfo(package);

        packageCount += 1; 
    });

    if ( packageCount < 1 )
    {
        wcout << L"No packages were found." << endl;
    }

    return 0;
}

void DisplayPackageInfo(Windows::ApplicationModel::Package^ package)
{
    wcout << L"Name: " << package->Id->Name->Data() << endl;
    wcout << L"FullName: " << package->Id->FullName->Data() << endl;
    wcout << L"Version: " << package->Id->Version.Major << "." << 
        package->Id->Version.Minor << "." << package->Id->Version.Build << 
        "." << package->Id->Version.Revision << endl;
    wcout << L"Publisher: " << package->Id->Publisher->Data() << endl;
    wcout << L"PublisherId: " << package->Id->PublisherId->Data() << endl;
    wcout << L"Installed Location: " << package->InstalledLocation->Path->Data() << endl;
    wcout << L"IsFramework: " << (package->IsFramework ? L"True" : L"False") << endl;
}

備註

這個方法需要系統管理許可權。否則會擲回 AccessDeniedException 。

另請參閱

適用於

共用方式為

PackageManager.FindPackages 方法

定義

多載

FindPackages(String, String)

參數

傳回

Windows 需求

備註

另請參閱

適用於

FindPackages(String)

參數

傳回

Windows 需求

備註

另請參閱

適用於

FindPackages()

傳回

Windows 需求

範例

備註

另請參閱

適用於

意見反應

其他資源