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 パラメーターは、パッケージ名とパッケージ発行者ハッシュで構成される 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)

戻り値

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 の要件

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース