Package.FindRelatedPackages(FindRelatedPackagesOptions) Methode

Referenz

Definition

Namespace:: Windows.ApplicationModel

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Die FindRelatedPackages-Methode stellt die Abhängigkeiten und dann Abhängigkeiten für ein bestimmtes Paket als Paketliste bereit. Die Liste kann mithilfe des Optionsparameters nach dem Typ der Abhängigkeit gefiltert werden.

public:
 virtual IVector<Package ^> ^ FindRelatedPackages(FindRelatedPackagesOptions ^ options) = FindRelatedPackages;

IVector<Package> FindRelatedPackages(FindRelatedPackagesOptions const& options);

public IList<Package> FindRelatedPackages(FindRelatedPackagesOptions options);

function findRelatedPackages(options)

Public Function FindRelatedPackages (options As FindRelatedPackagesOptions) As IList(Of Package)

Parameter

options: FindRelatedPackagesOptions

FindRelatedPackageOptions, das die Suchoptionen definiert.

Gibt zurück

IVector<Package>

IList<Package>

Gibt ein IList-Paket> zurück,< das die Ergebnisse der Suche enthält.

Windows-Anforderungen

Gerätefamilie	Windows 11 Insider Preview (eingeführt in 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v15.0)

Beispiele

Beispiel zum Abrufen von Anzeigenamen abhängiger Pakete

Für ein Host Runtime-Anbieterpaket ist die Liste der abhängigen Pakete nützlich, um dem Benutzer angezeigt zu werden. Im folgenden Beispiel ruft das aktuelle Paket die Liste der Anzeigenamen aller Hostruntime-Consumer ab, die davon abhängig sind.

static List<string> GetDisplayNamesOfHostedAppsForCurrentPackage()
{
  List<string> displayNames = new();

  // Configure package options to get packages dependent on the app package
  var pkgdependents = PackageRelationship.Dependents;                      
  FindRelatedPackagesOptions hostRuntimeDependents = new(pkgdependents)
  {
      IncludeFrameworks = false,
      IncludeHostRuntimes = true,
      IncludeOptionals = false,
      IncludeResources = false
  };

  // Get a list of packages which are dependent on the app package.
  IList<Package> hostedPackages = Package.Current.FindRelatedPackages(hostRuntimeDependents);

  // Iterate over the dependent packages and get their display names.
  foreach (Package package in hostedPackages)
  {
    displayNames.Add(package.DisplayName);
  }

  return displayNames;
}

Beispiel zum Abrufen von Paketabhängigkeiten

Ein abhängiges Paket kann auch weitere Informationen zu seinen Abhängigkeiten sammeln und unterschiedliche Fälle entsprechend behandeln. Im folgenden Beispiel ruft das aktuelle Paket die Liste der Pakete ab, von denen es über eine nicht optionale Abhängigkeit verfügt.

static IList<Package> GetNonOptionalDependenciesForCurrentPackage()
{
  // Configure package options to get non-optional dependencies
  var pkgdependents = PackageRelationship.Dependencies;                      
  FindRelatedPackagesOptions nonOptionalDependency = new(pkgdependents)
  {
      IncludeFrameworks = true,
      IncludeHostRuntimes = true,
      IncludeOptionals = false,
      IncludeResources = true
  };

  // Find and return the packages which are non-optional dependencies
  return Package.Current.FindRelatedPackages(nonOptionalDependency);
}

Hinweise

Jeder Aufrufer (mit der packageQuery-Funktion oder mittlerer IL oder ohne, wenn der Aufruf für das aktuelle Paket gilt) kann diese API verwenden, um die Liste der abhängigen Elemente (jedes Paket, das eine Abhängigkeit in seinem Manifest definiert) eines bestimmten Pakets abzurufen. Das Paket kann diese Daten verwenden, um dem Benutzer seine Consumer anzuzeigen oder auf derEn Grundlage Wartungsentscheidungen zu treffen. Beispielsweise kann Edge alle auf dem Gerät installierten PWAs anzeigen. Diese API kennt alle registrierten Pakete.

Gilt für:

Freigeben über