PackageManager.FindPackages 方法

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)

參數

傳回

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

屬性

OverloadAttribute

Windows 需求

備註

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

另請參閱

• FindPackages()
• 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)

參數

傳回

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

屬性

OverloadAttribute

Windows 需求

備註

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

另請參閱

• FindPackages()
• FindPackages(String, String)
• 套件

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)

傳回

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

屬性

OverloadAttribute

Windows 需求

範例

此範例會使用 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 。

另請參閱

• FindPackages(String)
• FindPackages(String, String)
• 套件
• 列舉應用程式套件範例