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 (包) 集合中的每个包。此方法不同于 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);
}

另请参阅 Visual Studio 对 C++/WinRT 的支持。

// 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 要求

示例

注解

另请参阅

适用于

反馈

反馈

其他资源