Share via


PackageManager.FindPackages メソッド

定義

オーバーロード

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 にすることはできません。

戻り値

メソッドが成功すると、同じパッケージ名と発行元名を持つパッケージ オブジェクトの列挙可能なコレクションが返されます。 このコレクション内の各 Package オブジェクトには、パッケージの名前、発行元、バージョン、インストール場所など、パッケージに関する情報が含まれますが、これらに限定されません。 指定した名前と発行元のパッケージが見つからない場合、このメソッドは空のリストを返します。

属性

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 にすることはできません。

戻り値

メソッドが成功すると、同じパッケージ ファミリ名を持つパッケージ オブジェクトの列挙可能なコレクションが返されます。 このコレクション内の各 Package オブジェクトには、パッケージの名前、発行元、バージョン、インストール場所など、パッケージに関する情報が含まれますが、これらに限定されません。 指定したパッケージ ファミリ名を持つパッケージが見つからない場合、このメソッドは空のリストを返します。

属性

Windows の要件

アプリの機能
packageQuery

注釈

この方法には管理特権が必要です。 IIterable(Package) コレクション内の各パッケージは、現在のユーザーまたは別のユーザーにインストールできます。 このメソッドは 、FindPackages(String packageName, String pulisherName) メソッドとは異なります。 ここで packageFamilyName パラメーターは、パッケージ名とパッケージ発行者ハッシュで構成される 1 つの文字列です。

こちらもご覧ください

適用対象

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)

戻り値

メソッドが成功すると、パッケージ オブジェクトの列挙可能なコレクションが返されます。 このコレクション内の各 Package オブジェクトには、パッケージの名前、発行元、バージョン、インストール場所など、パッケージに関する情報が含まれますが、これらに限定されません。

属性

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 がスローされます。

こちらもご覧ください

適用対象