PackageDependency.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| Add() |
Ajoute une référence au moment de l’exécution pour la dépendance de package framework que vous avez créée précédemment à l’aide de la méthode Create . Une fois cette méthode retournée, votre application peut activer des types et utiliser du contenu à partir du package d’infrastructure. |
| Add(AddPackageDependencyOptions) |
Ajoute une référence au moment de l’exécution pour la dépendance de package framework que vous avez créée précédemment à l’aide de la méthode Create , avec les options spécifiées. Une fois cette méthode retournée, votre application peut activer des types et utiliser du contenu à partir du package d’infrastructure. |
Add()
public:
virtual PackageDependencyContext ^ Add() = Add;/// [Windows.Foundation.Metadata.Overload("Add")]
PackageDependencyContext Add();[Windows.Foundation.Metadata.Overload("Add")]
public PackageDependencyContext Add();function add()Public Function Add () As PackageDependencyContextRetours
Objet qui fournit des informations contextuelles sur la dépendance de package framework et vous permet de supprimer la référence au moment de l’exécution.
- Attributs
Remarques
L’appel de cette méthode résout la dépendance du package d’infrastructure en un package spécifique sur le système. Il informe également le système d’exploitation que le package d’infrastructure est en cours d’utilisation active et de gérer les mises à jour de version de manière côte à côte (retardez efficacement la désinstallation ou la maintenance de l’ancienne version jusqu’à ce que votre application ait terminé de l’utiliser). La résolution de package est spécifique à un utilisateur et peut retourner différentes valeurs pour différents utilisateurs sur un système.
Chaque appel Add réussi ajoute le package résolu au graphe de package du processus appelant, même s’il est déjà présent. Il n’existe aucune détection ou filtrage en double appliqué par l’API (autrement dit, plusieurs références d’un package ne sont pas dangereuses). Une fois la résolution terminée, la dépendance de package reste résolue pour cet utilisateur jusqu’à ce que la dernière référence sur tous les processus de cet utilisateur soit supprimée via PackageDependencyContext.Remove ou que le processus soit arrêté. Les appels réussis à cette méthode modifient la valeur PackageDependency.GenerationId .
Une fois cette méthode retournée, votre application peut activer des types et utiliser du contenu à partir du package d’infrastructure jusqu’à ce que PackageDependencyContext.Remove soit appelé.
Si plusieurs packages sont présents dans le graphique de package avec le même rang que l’appel à Ajouter, le package résolu est ajouté après d’autres personnes du même rang.
Pour plus d’informations, consultez Utiliser l’API de dépendance dynamique pour référencer des packages MSIX au moment de l’exécution.
Voir aussi
S’applique à
Add(AddPackageDependencyOptions)
Ajoute une référence au moment de l’exécution pour la dépendance de package framework que vous avez créée précédemment à l’aide de la méthode Create , avec les options spécifiées. Une fois cette méthode retournée, votre application peut activer des types et utiliser du contenu à partir du package d’infrastructure.
public:
virtual PackageDependencyContext ^ Add(AddPackageDependencyOptions ^ options) = Add;/// [Windows.Foundation.Metadata.Overload("Add2")]
PackageDependencyContext Add(AddPackageDependencyOptions const& options);[Windows.Foundation.Metadata.Overload("Add2")]
public PackageDependencyContext Add(AddPackageDependencyOptions options);function add(options)Public Function Add (options As AddPackageDependencyOptions) As PackageDependencyContextParamètres
- options
- AddPackageDependencyOptions
Définit des options supplémentaires pour spécifier la référence du package d’infrastructure.
Retours
Objet qui fournit des informations contextuelles sur la dépendance de package framework et vous permet de supprimer la référence au moment de l’exécution.
- Attributs
Remarques
L’appel de cette méthode résout la dépendance du package d’infrastructure en un package spécifique sur le système. Il informe également le système d’exploitation que le package d’infrastructure est en cours d’utilisation active et de gérer les mises à jour de version de manière côte à côte (retardez efficacement la désinstallation ou la maintenance de l’ancienne version jusqu’à ce que votre application ait terminé de l’utiliser). La résolution de package est spécifique à un utilisateur et peut retourner différentes valeurs pour différents utilisateurs sur un système.
Chaque appel Add réussi ajoute le package résolu au graphe de package du processus appelant, même s’il est déjà présent. Il n’existe aucune détection ou filtrage en double appliqué par l’API (autrement dit, plusieurs références d’un package ne sont pas dangereuses). Une fois la résolution terminée, la dépendance de package reste résolue pour cet utilisateur jusqu’à ce que la dernière référence sur tous les processus de cet utilisateur soit supprimée via PackageDependencyContext.Remove ou que le processus soit arrêté. Les appels réussis à cette méthode modifient la valeur PackageDependency.GenerationId .
Une fois cette méthode retournée, votre application peut activer des types et utiliser du contenu à partir du package d’infrastructure jusqu’à ce que PackageDependencyContext.Remove soit appelé.
Si plusieurs packages sont présents dans le graphique de package avec le même rang que l’appel à Ajouter, le package résolu est ajouté (par défaut) après d’autres personnes du même rang. Pour ajouter un package avant d’autres personnes du même rang, spécifiez PrependIfRankCollision pour le paramètre d’options .
Pour plus d’informations, consultez Utiliser l’API de dépendance dynamique pour référencer des packages MSIX au moment de l’exécution.